CL_CrlGetNextCachedFieldValue(3)CL_CrlGetNextCachedFieldValue(3)NAME
CL_CrlGetNextCachedFieldValue, CSSM_CL_CrlGetNextCachedFieldValue - Get
the value of the next cached CRL field (CDSA)
SYNOPSIS
# 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
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 "(*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
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 revoca‐
tion records or within one revocation record. The scope of the scan was
set by an optional CrlRecordIndex input to the function CSSM_CL_CrlGet‐
FirstCachedFieldValue() (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 multi‐
ple revocation records in a CRL.
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_CrlGetFirstCachedFieldValue(3), CSSM_CL_CrlAbortQuery(3),
CSSM_CL_IsCertInCachedCrl(3), CSSM_CL_CrlCache(3), CSSM_CL_CrlAbort‐
Cache(3), CSSM_CL_FreeFieldValue(3)
Functions for the CLI SPI:
CL_CrlGetFirstCachedFieldValue(3), CL_CrlAbortQuery(3), CL_IsCertIn‐
CachedCrl(3), CL_CrlCache(3), CL_CrlAbortCache(3), CL_FreeFieldValue(3)CL_CrlGetNextCachedFieldValue(3)