Index for Section 3

Alphabetical listing for C

Bottom of page

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 CLHandle,
       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
  CLHandle (input)
	  The handle that describes the add-in Certificate Library module
	  used to perform this function.

  Crl (input)
	  A pointer to the CSSM_DATA structure that contains the encoded,
	  packed CRL from which field values are to be extracted.

  NumberOfCrlFields (output)
	  The number of entries in the array CrlFields.

  CrlFields (output)
	  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 structure
  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 represent
  an error condition.

ERRORS
  Errors are described in the CDSA technical standard.	See CDSA_intro(3).

       CSSMERR_CL_INVALID_CRL_POINTER
       CSSMERR_CL_UNKNOWN_FORMAT

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)

Index for Section 3

Alphabetical listing for C

Top of page