CL_CertCreateTemplate

If both a Table of Contents and Search form are not displayed in separate frames along with this one, you may wish to redisplay this book in a frameset, beginning with the first page.

HP Open Source Security for OpenVMS Volume 1:...

API Functions

CL_CertCache

CL_CertDescribeFormat

CL_CertCreateTemplate

Library
Description
Errors

Parameters
Return Value
See Also

NAME

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

SYNOPSIS

# include <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

Common Security Services Manager library (cdsa$incssm300_shr.exe)

PARAMETERS

`CLHandle` (input)
		The handle that describes the certificate librarymodule used to perform this function.
`NumberOfFields` (input)
		The number of certificate field values specifiedin the `CertFields`.
`CertFields` (input)
		A pointer to an array of OID/value pairs that identifythe field values to initialize a new certificate.
`CertTemplate` (output)
		A pointer to a CSSM_DATA structure that will containthe unsigned certificate template as a result of this function.

DESCRIPTION

This function allocates and initializes memory for an encodedcertificate template output in CertTemplate->Data.The template values are specified by the input OID/value pairs containedin CertFields. The initialization process includesencoding all certificate field values according to the certificatetype and certificate encoding supported by the certificate librarymodule.

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

RETURN VALUE

A CSSM_RETURN value indicating success or specifying a particularerror condition. The value CSSM_OK indicates success. All othervalues represent an error condition.

ERRORS

Errors are described in the CDSA Technical Standard.

CSSMERR_CL_INVALID_FIELD_POINTERCSSMERR_CL_UNKNOWN_TAGCSSMERR_CL_INVALID_NUMBER_OF_FIELDS