This function allocates and initializes memory for a certificate based on the input OID/value pairs specified in the CertTemplate. The initialization process includes encoding all certificate field values according to the format required by the certificate representation. The function returns the initialized template containing encoded values. The memory is allocated using the calling application's memory management routines.

CSSM_DATA_PTR CSSMAPI CSSM_CL_CertCreateTemplate
                 (CSSM_CL_HANDLE CLHandle,
                 const CSSM_FIELD_PTR CertTemplate, 
                 uint32 NumberOfFields)

Input

CLHandle

The handle that describes the CL module used to perform this function.

CertTemplate

A pointer to an array of OID/value pairs that identify the field values to initialize a new certificate.

NumberOfFields

The number of certificate field values specified in the CertTemplate.

A pointer to the CSSM_DATA structure containing the unsigned certificate template. If the return pointer is NULL, an error has occurred. Use CSSM_GetError to obtain the error code.