CL_CrlGetAllFields(3)CL_CrlGetAllFields(3)NAME
CL_CrlGetAllFields, CSSM_CL_CrlGetAllFields - Get the field values from
the CRL (CDSA)
SYNOPSIS
# include <cdsa/cssm.h>
API: CSSM_RETURN CSSMAPI CSSM_CL_CrlGetAllFields (CSSM_CL_HANDLE CLHan‐
dle, const CSSM_DATA *Crl, uint32 *NumberOfCrlFields, CSSM_FIELD_PTR
*CrlFields) SPI: CSSM_RETURN CSSMCLI CL_CrlGetAllFields (CSSM_CL_HANDLE
CLHandle, const CSSM_DATA *Crl, uint32 *NumberOfCrlFields,
CSSM_FIELD_PTR *CrlFields)
LIBRARY
Common Security Services Manager library (libcssm.so)
PARAMETERS
The handle that describes the add-in Certificate Library module used to
perform this function. A pointer to the CSSM_DATA structure that con‐
tains the encoded, packed CRL from which field values are to be
extracted. The number of entries in the array CrlFields. A pointer to
an array of OID-value pairs that describe the contents of the CRL. The
extracted CRL fields are returned as the value portion of each OID-
value pair. The field list is allocated by the service provider and
must be deallocated by the application by calling CSSM_CL_FreeFields()
(CSSM API), or CL_FreeFields() (CL SPI).
DESCRIPTION
This function returns one or more structures. Each structure contains a
set of field values from the encoded, packed CRL contained in Crl. Each
structure is returned in the FieldValue entry of the CSSM_FIELD struc‐
ture CrlFields. The parameter NumberOfCrlFields indicates the number of
returned structures.
The CRL can be signed or unsigned. This function does not perform any
signature verification on the CRL fields or the CRL records. Each CRL
record can be digitally signed when it is added to the CRL using the
function CSSM_CL_CrlAddCert() (CSSM API), or CL_CrlAddCert() (CL SPI).
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_CRL_POINTER CSSMERR_CL_UNKNOWN_FOR‐
MAT
SEE ALSO
Books
Intel CDSA Application Developer's Guide (see CDSA_intro(3))
Reference Pages
Functions for the CSSM API:
CSSM_CL_FreeFields(3)
Functions for the CLI SPI:
CL_FreeFields(3)CL_CrlGetAllFields(3)