z/OS Open Cryptographic Services Facility Application Programming
Previous topic | Next topic | Contents | Index | Contact z/OS | Library | PDF


CSSM_CL_CrlAddCert

z/OS Open Cryptographic Services Facility Application Programming
SC24-5899-01

Purpose

This function revokes the input certificate by adding a record representing the certificate to the CRL. The values for the new entry in the CRL are specified by the list of OID/value input pairs. The reason for revocation is a typical value specified in the list. The revoker's certificate is used to sign the new CRL entry. The operation is valid only if the CRL has not been closed by the process of signing the CRL (i.e., execution of the function CSSM_CL_CrlSign). Once the CRL has been signed, entries can not be added or removed.

Format

CSSM_DATA_PTR CSSMAPI CSSM_CL_CrlAddCert
                 (CSSM_CL_HANDLE CLHandle,
                 CSSM_CC_HANDLE CCHandle,
                 const CSSM_DATA_PTR Cert,
                 const CSSM_DATA_PTR RevokerCert,
                 const CSSM_FIELD_PTR CrlEntryFields,
                 uint32 NumberOfFields,
                 const CSSM_DATA_PTR OldCrl)

Parameters

Input

CLHandle
The handle that describes the CL module used to perform this function.
CCHandle
The handle that describes the context of this cryptographic operation.
Cert
A pointer to the CSSM_DATA structure containing the certificate to be revoked.
RevokerCert
A pointer to the CSSM_DATA structure containing the revoker's certificate.
CrlEntryFields
An array of OID/value pairs specifying the initial values for descriptive data fields of the new CRL entry.
NumberOfFields
The number of OID/value pairs specified in the CrlEntryFields input parameter.
OldCrl
A pointer to the CSSM_DATA structure containing the CRL to which the newly revoked certificate will be added.

Return Value

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

Related Information

CSSM_CL_CrlRemoveCert

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014