CL_CrlGetNextFieldValue
CSSM_DATA_PTR CSSMCLI CL_CrlGetNextFieldValue
(CSSM_CL_HANDLE CLHandle,
CSSM_HANDLE ResultsHandle)
This function returns the value of a CRL field, when that field occurs multiple times in a CRL. CRLs 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.
- 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.
Returns a pointer to a CSSM_DATA structure containing the next field in the CRL, which 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.
- CSSM_CL_INVALID_CL_HANDLE
Invalid Certificate Library Handle.
- CSSM_CL_INVALID_RESULTS_HANDLE
Invalid results handle.
- CSSM_CL_MEMORY_ERROR
Not enough memory.
- CSSM_CL_NO_FIELD_VALUES
No field values for this results handle.
- CSSM_CL_CRL_GET_FIELD_VALUE_FAIL
Unable to get field value.
CL_CrlGetFirstFieldValue, CL_CrlAbortQuery
Contents | Next section | Index |