CL_CrlCreateTemplate

NAME

  CL_CrlCreateTemplate,
  CSSM_CL_CrlCreateTemplate - Create an unsigned, memory-resident 
  CRL (CDSA)

SYNOPSIS

  # include <cssm.h>

   API:
       CSSM_RETURN CSSMAPI CSSM_CL_CrlCreateTemplate
       (CSSM_CL_HANDLE CLHandle,
       uint32 NumberOfFields,
       const CSSM_FIELD *CrlTemplate,
       CSSM_DATA_PTR NewCrl)

   SPI:
       CSSM_RETURN CSSMCLI CL_CrlCreateTemplate
       (CSSM_CL_HANDLE CLHandle,
       uint32 NumberOfFields,
       const CSSM_FIELD *CrlTemplate,
       CSSM_DATA_PTR NewCrl)

LIBRARY

  Common Security Services Manager library (CDSA$INCSSM300_SHR.EXE)

PARAMETERS

  CLHandle (input)
          The handle that describes the add-in Certificate Library module
          used to perform this function.

  NumberOfFields (input)
          The number of OID/value pairs specified in the CrlTemplate input
          parameter.

  CrlTemplate (input)
          An array of OID/value pairs specifying the initial values for
          descriptive data fields of the new CRL.

  NewCrl (output)
          A pointer to the CSSM_DATA structure containing the new CRL.
          The NewCrl-> Data is allocated by the service provider and
          must be deallocated by the application.

DESCRIPTION

  This function creates an unsigned, memory-resident CRL. Fields in the
  CRL are initialized with the descriptive data specified by the OID/value
  input pairs. The specified OID/value pairs can initialize all or a
  subset of the general attribute fields in the new CRL. Subsequent values
  can be set using the CSSM_CL_CrlSetFields() (CSSM API) or the
  CL_CrlSetFields() (CL SPI) function. The new CRL contains no revocation
  records.

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.

       CSSMERR_CL_INVALID_FIELD_POINTER
       CSSMERR_CL_UNKNOWN_TAG
       CSSMERR_CL_INVALID_NUMBER_OF_FIELDS
       CSSMERR_CL_INVALID_CRL_POINTER

SEE ALSO

  Books

  Intel CDSA Application Developer's Guide (see CDSA)

  Other Help Topics

  Functions for the CSSM API:

      CSSM_CL_CrlSetFields
      CSSM_CL_CrlAddCert
      CSSM_CL_CrlSign
      CSSM_CL_CertGetFirstFieldValue

  Functions for the CLI SPI:

      CL_CrlSetFields
      CL_CrlAddCert
      CL_CrlSign
      CL_CertGetFirstFieldValue