TP_CrlCreateTemplate

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