*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> CSSM_CL_CertGetNextFieldValue (3)              
Title
Content
Arch
Section
 

CL_CertGetNextFieldValue(3)

Contents


NAME    [Toc]    [Back]

       CL_CertGetNextFieldValue,  CSSM_CL_CertGetNextFieldValue -
       Return the value of a certificate field (CDSA)

SYNOPSIS    [Toc]    [Back]

       # include <cdsa/cssm.h>

       API:  CSSM_RETURN  CSSMAPI   CSSM_CL_CertGetNextFieldValue
       (CSSM_CL_HANDLE   CLHandle,   CSSM_HANDLE   ResultsHandle,
       CSSM_DATA_PTR *Value) SPI: CSSM_RETURN CSSMCLI CL_CertGetNextFieldValue
   (CSSM_CL_HANDLE   CLHandle,   CSSM_HANDLE
       ResultsHandle, CSSM_DATA_PTR *Value)

LIBRARY    [Toc]    [Back]

       Common Security Services Manager library (libcssm.so)

PARAMETERS    [Toc]    [Back]

       The handle that describes the add-in  certificate  library
       module  used  to  perform  this function.  The handle that
       identifies the results of a certificate query.  A  pointer
       to  the  structure  containing  the value of the requested
       field. The structure and the field at  I  "(*Value)->Data"
       are    allocated    by    the    service   provider.   The
       CSSM_CL_FreeFieldValue() (CSSM API) or CL_FreeFieldValue()
       (CL  SPI),  function  can be used to deallocate *Value and
       (*Value)->Data.

DESCRIPTION    [Toc]    [Back]

       This function returns the value of  a  certificate  field,
       when  that  field  occurs multiple times in a certificate.
       Certificates with repeated fields (such as multiple signatures)
  have multiple field values corresponding to a single
 OID. A call to the function CSSM_CL_CertGetFirstFieldValue()
  (CSSM  API),  or  CL_CertGetFirstFieldValue() (CL
       SPI), returns a results handle identifying  the  size  and
       values  contained  in the result set. The CSSM_CL_CertGetNextFieldValue()
 (CSSM API), or CL_CertGetNextFieldValue()
       (CL  SPI),  function  can  be  called repeatedly to obtain
       these values, one at a  time.  The  result  set  does  not
       change in size or value between calls to this function.

RETURN VALUE    [Toc]    [Back]

       A  CSSM_RETURN  value  indicating  success or specifying a
       particular error condition. The  value  CSSM_OK  indicates
       success. All other values represent an error condition.

ERRORS    [Toc]    [Back]

       Errors  are described in the CDSA technical standard.  See
       CDSA_intro(3).    CSSMERR_CL_INVALID_RESULTS_HANDLE   CSSMERR_CL_NO_FIELD_VALUES


SEE ALSO    [Toc]    [Back]

      
      
       Books

       Intel    CDSA    Application    Developer's   Guide   (see
       CDSA_intro(3))

       Reference Pages    [Toc]    [Back]

       Functions for the CSSM API:

       CSSM_CL_CertGetFirstFieldValue(3),      CSSM_CL_CertAbortQuery(3), CSSM_CL_FreeFieldValue(3)

       Functions for the CLI SPI:

       CL_CertGetFirstFieldValue(3),        CL_CertAbortQuery(3),
       CL_FreeFieldValue(3)



                                      CL_CertGetNextFieldValue(3)
[ Back ]
 Similar pages
Name OS Title
CL_CertGetFirstFieldValue Tru64 Return the value of the certificate field (CDSA)
CSSM_CL_CertGetFirstFieldValue Tru64 Return the value of the certificate field (CDSA)
CL_CrlGetAllCachedRecordFields Tru64 Return field values from a CRL record (CDSA)
CSSM_CL_CrlGetAllCachedRecordFields Tru64 Return field values from a CRL record (CDSA)
CL_CertGetFirstCachedFieldValue Tru64 Return values from the cached certificate (CDSA)
CSSM_CL_CertGetFirstCachedFieldValue Tru64 Return values from the cached certificate (CDSA)
CSSM_CL_CertGetAllFields Tru64 Return a list of input certificate values (CDSA)
CL_CertGetAllFields Tru64 Return a list of input certificate values (CDSA)
CSSM_CL_CertGroupToSignedBundle Tru64 Convert a certificate group to a certificate bundle (CDSA)
CL_CertGroupToSignedBundle Tru64 Convert a certificate group to a certificate bundle (CDSA)
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service