Previous section.

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

NAME

CL_CrlSetFields

SYNOPSIS

CSSM_DATA_PTR CSSMCLI CL_CrlSetFields
    (CSSM_CL_HANDLE CLHandle,
    const CSSM_FIELD_PTR CrlTemplate,
    uint32 NumberOfFields,
    const CSSM_DATA_PTR OldCrl);

DESCRIPTION

This function will set the fields of the input CRL to the new values, specified by the input OID/value pairs. The module developer may specify a set of fields that must be or cannot be set using this operation. This operation is valid only if the CRL has not been closed by the process of signing the CRL (that is, execution of the function CSSM_CL_CrlSign). Once the CRL has been signed, fields cannot be changed.

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.

OldCrl (input)

The CRL to be updated with the new attribute values. The CRL must be unsigned and available for update.

RETURN VALUE

A pointer to the modified, unsigned 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_INVALID_FIELD_POINTER

Invalid pointer input.

CSSM_CL_INVALID_TEMPLATE

Invalid template for this CRL type.

CSSM_CL_MEMORY_ERROR

Not enough memory.

CSSM_CL_UNSUPPORTED_OPERATION

Add-in does not support this function.

CSSM_CL_CRL_SET_FAIL

Unable to set CRL field values.

SEE ALSO

CSSM_CL_CrlCreateTemplate, 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