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)