CL_CrlCreateTemplate

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_CrlCache

CL_CrlDescribeFormat

CL_CrlCreateTemplate

Library
Description
Errors

Parameters
Return Value
See Also

NAME

CL_CrlCreateTemplate: CSSM_CL_CrlCreateTemplate - Create an unsigned, memory-resident CRL (CDSA)

SYNOPSIS

# include <cssm.h>

API:CSSM_RETURN CSSMAPI CSSM_CL_CrlCreateTemplate(CSSM_CL_HANDLE CLHandle,uint32 NumberOfFields,const CSSM_FIELD *CrlTemplate,CSSM_DATA_PTR NewCrl)SPI:CSSM_RETURN CSSMCLI CL_CrlCreateTemplate(CSSM_CL_HANDLE CLHandle,uint32 NumberOfFields,const CSSM_FIELD *CrlTemplate,CSSM_DATA_PTR NewCrl)

LIBRARY

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

PARAMETERS

`CLHandle` (input)
		The handle that describes the add-in CertificateLibrary module used to perform this function.
`NumberOfFields` (input)
		The number of OID/value pairs specified in the CrlTemplateinput parameter.
`CrlTemplate` (input)
		An array of OID/value pairs specifying the initialvalues for descriptive data fields of the new CRL.
`NewCrl` (output)
		A pointer to the CSSM_DATA structure containingthe new CRL. The `NewCrl-> Data` is allocatedby the service provider and must be deallocated by the application.

DESCRIPTION

This function creates an unsigned, memory-resident CRL. Fieldsin the CRL are initialized with the descriptive data specified bythe OID/value input pairs. The specified OID/value pairs can initializeall or a subset of the general attribute fields in the new CRL.Subsequent values can be set using the CSSM_CL_CrlSetFields() (CSSM API) or the CL_CrlSetFields() (CL SPI) function. The new CRL contains no revocationrecords.

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_FIELDSCSSMERR_CL_INVALID_CRL_POINTER