Previous section.

Common Security: CDSA and CSSM
Copyright © 1997 The Open Group

NAME

CL_CrlCreateTemplate

SYNOPSIS

CSSM_DATA_PTR CSSMCLI CL_CrlCreateTemplate
    (CSSM_CL_HANDLE CLHandle
    const CSSM_FIELD_PTR CrlTemplate,
    uint32 NumberOfFields)

DESCRIPTION

This function creates an unsigned, memory-resident CRL. Fields in the CRL are initialized with the descriptive data specified by the OID/value input pairs. The specified OID/value pairs can initialize all or a subset of the general attribute fields in the new CRL, though the module developer may specify a set of fields that must be or cannot be set using this operation. Subsequent values may be set using the CSSM_CL_CrlSetFields operation.

PARAMETERS

CLHandle (input)

The handle that describes the add-in certificate library module used to perform this function.

CrlTemplate (input)

Any array of field OID/value pairs containing the values to initialize the CRL attribute fields.

NumberOfFields (input)

The number of OID/value pairs specified in the CrlTemplate input parameter.

RETURN VALUE

A pointer to the CSSM_DATA structure containing the new CRL. If the pointer is NULL, an error has occurred. Use CSSM_GetError to obtain the error code.

ERRORS

CSSM_CL_INVALID_CL_HANDLE

Invalid CL handle.

CSSM_CL_MEMORY_ERROR

Not enough memory to allocate for the CRL.

CSSM_CL_CRL_CREATE_FAIL

Unable to create CRL.

SEE ALSO

CSSM_CL_CrlSetFields, CSSM_CL_CrlAddCert,
CSSM_CL_CrlSign, CSSM_CL_CertGetFirstFieldValue

Why not acquire a nicely bound hard copy?
Click here to return to the publication details or order a copy of this publication.
You should also read the legal notice explaining the terms and conditions relating to the CDSA documentation.

Contents Next section Index