NAME
   TP_CrlCreateTemplate,
   CSSM_TP_CrlCreateTemplate - Create an unsigned memory-resident CRL
                               template (CDSA)

 SYNOPSIS
   # include <cssm.h>

    API:
        CSSM_RETURN CSSMAPI CSSM_TP_CrlCreateTemplate
        (CSSM_TP_HANDLE TPHandle,
        CSSM_CL_HANDLE CLHandle,
        uint32 NumberOfFields,
        const CSSM_FIELD *CrlFields,
        CSSM_DATA_PTR NewCrlTemplate)
    SPI:
        CSSM_RETURN CSSMTPI TP_CrlCreateTemplate
        (CSSM_TP_HANDLE TPHandle,
        CSSM_CL_HANDLE CLHandle,
        uint32 NumberOfFields,
        const CSSM_FIELD *CrlFields,
        CSSM_DATA_PTR NewCrlTemplate)

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

 PARAMETERS
   TPHandle (input)
           The handle that describes the add-in trust policy module used
           to perform this function.

   CLHandle (input/optional)
           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 CrlFields
           input parameter.

   CrlFields (input)
           Any array of field OID/value pairs containing the values to
           initialize the CRL attribute fields

   NewCrlTemplate (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 template.
   Fields in the CRL are initialized based on the descriptive data
   specified by the OID/value input pairs in CrlFields and the local
   domain policy of the TP.  The specified OID/value pairs can
   initialize all or a subset of the general attribute fields in the
   new CRL, though the module developer may specify a set of fields
   that must be or cannot be set using this operation.  The
   NewCrlTemplate output is an unsigned CRL template in the format
   supported by the TP.

 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_TP_INVALID_CL_HANDLE
        CSSMERR_TP_INVALID_FIELD_POINTER
        CSSMERR_TP_UNKNOWN_TAG
        CSSMERR_TP_INVALID_NUMBER_OF_FIELDS

 SEE ALSO
   Books

   Intel CDSA Application Developer's Guide (see CDSA)

   Other Help Topics

   Functions for the CSSM API:

       CSSM_TP_CrlSignWithKey
       CSSM_TP_CrlSignWithCert

   Functions for the TP SPI:

       TP_CrlSignWithKey
       TP_CrlSignWithCert