NAME    [Toc]    [Back]

       CL_CrlGetNextCachedFieldValue,   CSSM_CL_CrlGetNextCachedFieldValue
 - Get the value of the next  cached  CRL  field
       (CDSA)

SYNOPSIS    [Toc]    [Back]

       # include <cdsa/cssm.h>

       API:  CSSM_RETURN  CSSMAPI  CSSM_CL_CrlGetNextCachedFieldValue
 (CSSM_CL_HANDLE CLHandle, CSSM_HANDLE ResultsHandle,
       CSSM_DATA_PTR   *FieldValue)   SPI:   CSSM_RETURN  CSSMCLI
       CL_CrlGetNextCachedFieldValue  (CSSM_CL_HANDLE   CLHandle,
       CSSM_HANDLE ResultsHandle, CSSM_DATA_PTR *FieldValue)

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 "(*FiledValue)->Data" are
       allocated by the service provider. The  CSSM_CL_FreeFieldValue()
 (CSSM API), or CL_FreeFieldValue() (CL SPI), function
 can be used to deallocate  *FieldValue  and  (*FieldValue)->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_CrlGetFirstCachedFieldValue() (CSSM API), or
       CL_CrlGetFirstCachedFieldValue() (CL SPI),  initiates  the
       process  and  returns a ResultsHandle identifying the size
       and values contained in the result set.  The  CSSM_CL_CrlGetNextCachedFieldValue()
   (CSSM   API),   or  CL_CrlGetNextCachedFieldValue()
 (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.

       The result set selected by CSSM_CL_CrlGetFirstCachedFieldValue()
 (CSSM  API),  or  CL_CrlGetFirstCachedFieldValue()
       (CL  SPI),  and  identified by ResultsHandle can reference
       CRL fields repeated across multiple revocation records  or
       within  one  revocation  record. The scope of the scan was
       set by an optional CrlRecordIndex input  to  the  function
       CSSM_CL_CrlGetFirstCachedFieldValue()   (CSSM   API),   or
       CL_CrlGetFirstCachedFieldValue() (CL SPI). If  the  record
       index  was  specified, then the results set is the revocation
 record identified by the index. If  no  record  index
       was  specified,  then the results set can include repeated
       fields from multiple revocation records in a CRL.

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_CrlGetFirstCachedFieldValue(3),  CSSM_CL_CrlAbortQuery(3),    CSSM_CL_IsCertInCachedCrl(3),    CSSM_CL_CrlCache(3),   CSSM_CL_CrlAbortCache(3),   CSSM_CL_FreeFieldValue(3)

       Functions for the CLI SPI:

       CL_CrlGetFirstCachedFieldValue(3),    CL_CrlAbortQuery(3),
       CL_IsCertInCachedCrl(3),    CL_CrlCache(3),   CL_CrlAbortCache(3), CL_FreeFieldValue(3)



                                 CL_CrlGetNextCachedFieldValue(3)