NAME    [Toc]    [Back]

       CL_CrlGetNextFieldValue,   CSSM_CL_CrlGetNextFieldValue  -
       Get the value of the next CRL field (CDSA)

SYNOPSIS    [Toc]    [Back]

       # include <cdsa/cssm.h>

       API:  CSSM_RETURN   CSSMAPI   CSSM_CL_CrlGetNextFieldValue
       (CSSM_CL_HANDLE   CLHandle,   CSSM_HANDLE   ResultsHandle,
       CSSM_DATA_PTR *Value) SPI: CSSM_RETURN CSSMCLI  CL_CrlGetNextFieldValue
   (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 CRL 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 CRL field, when  that
       field  occurs  multiple times in a CRL. CRLs with repeated
       fields (such as revocation records)  have  multiple  field
       values  corresponding to a single OID. A call to the function
  CSSM_CL_CrlGetFirstFieldValue()   (CSSM   API),   or
       CL_CrlGetFirstFieldValue() (CL SPI), initiates the process
       and returns a results handle identifying the size and values
  contained  in  the  result  set.  The CSSM_CL_CrlGetNextFieldValue()
 (CSSM API), or  CL_CrlGetNextFieldValue()
       (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_CrlGetFirstFieldValue(3), CSSM_CL_CrlAbortQuery(3)

       Functions for the CLI SPI:

       CL_CrlGetFirstFieldValue(3), CL_CrlAbortQuery(3)



                                       CL_CrlGetNextFieldValue(3)