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