CL_CrlGetNextFieldValue(3)			    CL_CrlGetNextFieldValue(3)

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

SYNOPSIS
       # 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
       Common Security Services Manager library (libcssm.so)

PARAMETERS
       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  deallo‐
       cate *Value and (*Value)->Data.

DESCRIPTION
       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_Crl‐
       GetNextFieldValue() (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
       A CSSM_RETURN value indicating success or specifying a particular error
       condition. The value CSSM_OK indicates success. All other values repre‐
       sent an error condition.

ERRORS
       Errors  are  described	in   the   CDSA	  technical   standard.	   See
       CDSA_intro(3).		CSSMERR_CL_INVALID_RESULTS_HANDLE	  CSS‐
       MERR_CL_NO_FIELD_VALUES

SEE ALSO
       Books

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

       Reference Pages

       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)

Vote for polarhome