NAME    [Toc]    [Back]

       CL_CertCreateTemplate,  CSSM_CL_CertCreateTemplate - Allocate
 and initialize  memory  for  a  certificate  template
       (CDSA)

SYNOPSIS    [Toc]    [Back]

       # include <cdsa/cssm.h>

       API:    CSSM_RETURN   CSSMAPI   CSSM_CL_CertCreateTemplate
       (CSSM_CL_HANDLE  CLHandle,  uint32  NumberOfFields,  const
       CSSM_FIELD  *CertFields,  CSSM_DATA_PTR CertTemplate) SPI:
       CSSM_RETURN CSSMCLI CL_CertCreateTemplate  (CSSM_CL_HANDLE
       CLHandle,  uint32  NumberOfFields, const CSSM_FIELD *CertFields,
 CSSM_DATA_PTR CertTemplate)

LIBRARY    [Toc]    [Back]

       Common Security Services Manager library (libcssm.so)

PARAMETERS    [Toc]    [Back]

       The handle that describes the certificate  library  module
       used  to perform this function.  The number of certificate
       field values specified in the CertFields.  A pointer to an
       array of OID/value pairs that identify the field values to
       initialize a new certificate.  A pointer  to  a  CSSM_DATA
       structure  that will contain the unsigned certificate template
 as a result of this function.

DESCRIPTION    [Toc]    [Back]

       This function allocates  and  initializes  memory  for  an
       encoded certificate template output in CertTemplate->Data.
       The template values are specified by the  input  OID/value
       pairs  contained in CertFields. The initialization process
       includes encoding all certificate field  values  according
       to the certificate type and certificate encoding supported
       by the certificate library module.

       The memory for CertTemplate->Data is allocated by the service
  provider using the calling application's memory management
 routines.  The  application  must  deallocate  the
       memory.

RETURN VALUE    [Toc]    [Back]

       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    [Toc]    [Back]

       Errors  are described in the CDSA technical standard.  See
       CDSA_intro(3).    CSSMERR_CL_INVALID_FIELD_POINTER    CSSMERR_CL_UNKNOWN_TAG
 CSSMERR_CL_INVALID_NUMBER_OF_FIELDS

SEE ALSO    [Toc]    [Back]

       Books

       Intel    CDSA    Application    Developer's   Guide   (see
       CDSA_intro(3))

       Reference Pages    [Toc]    [Back]

       Functions for the CSSM API:

       CSSM_CL_CertGetAllTemplateFields(3), CSSM_CL_CertSign(3)

       Functions for the CLI SPI:

       CL_CertGetAllTemplateFields(3), CL_CertSign(3)



                                         CL_CertCreateTemplate(3)