TP_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

TP_ApplyCrlToDb

TP_CertGetAllTemplateFields

TP_CertCreateTemplate

Library
Description
Errors

Parameters
Return Value
See Also

NAME

TP_CertCreateTemplate: CSSM_TP_CertCreateTemplate - Allocate and initialize template memory (CDSA)

SYNOPSIS

# include <cssm.h>

API:CSSM_RETURN CSSMAPI CSSM_TP_CertCreateTemplate(CSSM_TP_HANDLE TPHandle,CSSM_CL_HANDLE CLHandle,uint32 NumberOfFields,const CSSM_FIELD *CertFields,CSSM_DATA_PTR CertTemplate)SPI:CSSM_RETURN CSSMTPI TP_CertCreateTemplate(CSSM_TP_HANDLE TPHandle,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

`TPHandle` (input)
		The handle that describes the add-in trust policymodule used to perform this function.
`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 identifiesthe 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 template encoding supported by the trust policylibrary module. The CertTemplate output is anunsigned certificate template in the format supported by the TP.

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_TP_INVALID_CL_HANDLECSSMERR_TP_INVALID_FIELD_POINTERCSSMERR_TP_UNKNOWN_TAGCSSMERR_TP_INVALID_NUMBER_OF_FIELDS