NAME

CL_CertGetAllFields

SYNOPSIS

CSSM_FIELD_PTR CSSMCLI CL_CertGetAllFields
    (CSSM_CL_HANDLE CLHandle,
    const CSSM_DATA_PTR Cert,
    uint32 *NumberOfFields)

DESCRIPTION

This function returns a list of the fields in the input certificate, as described by their OID/value pairs.

PARAMETERS

CLHandle (input)

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

Cert (input)

A pointer to the CSSM_DATA structure containing the certificate whose fields will be returned.

NumberOfFields (output)

The length of the output CSSM_FIELD array.

RETURN VALUE

A pointer to an array of CSSM_FIELD structures that describe the contents of the certificate using OID/value pairs. If the return pointer is NULL, an error has occurred. Use CSSM_GetError to obtain the error code.

ERRORS

CSSM_CL_INVALID_CL_HANDLE

Invalid handle.

CSSM_CL_INVALID_POINTER

Invalid pointer.

CSSM_CL_MEMORY_ERROR

Error allocating memory.

CSSM_CL_CERT_GET_ALL_FIELDS_FAIL

Unable to return the list of fields.

SEE ALSO

CL_CertGetFirstFieldValue, CL_CertDescribeFormat