NAME

CSSM_CL_CrlGetNextFieldValue

SYNOPSIS

CSSM_DATA_PTR CSSMAPI CSSM_CL_CrlGetNextFieldValue
    (CSSM_CL_HANDLE CLHandle,
    CSSM_HANDLE ResultsHandle)

DESCRIPTION

This function returns the value of a CRL field, when that field occurs multiple times in a CRL. CRL with repeated fields (such as revocation records) have multiple field values corresponding to a single OID. A call to the function CSSM_CL_CrlGetFirstFieldValue initiates the process and returns a results handle identifying the CRL from which values are being obtained and the OID corresponding to those values. The CSSM_CL_CrlGetNextFieldValue function can be called repeatedly to obtain these values, one at a time.

PARAMETERS

CLHandle (input)

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

ResultsHandle (input)

The handle that identifies the results of a CRL query.

RETURN VALUE

Returns a pointer to a CSSM_DATA structure containing the next field in the CRL that matched the CrlField specified in the CL_CrlGetFirstFieldValue function. 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_NO_FIELD_VALUES

No more matches in the CRL.

CSSM_CL_INVALID_CRL_PTR

Invalid CRL pointer.

CSSM_CL_CRL_GET_FIELD_VALUE_FAIL

Unable to get next value.

SEE ALSO

CSSM_CL_CrlGetFirstFieldValue, CSSM_CL_CrlAbortQuery