CSSM_DATA_PTR CSSMCLI CL_CertGetNextFieldValue (CSSM_CL_HANDLE CLHandle, CSSM_HANDLE ResultsHandle)
This function returns the value of a certificate field, when that field occurs multiple times in a certificate. Certificates with repeated fields (such as multiple signatures) have multiple field values corresponding to a single OID. A call to the function CSSM_CL_CertGetFirstFieldValue initiates the process and returns a results handle identifying the certificate from which values are being obtained and the OID corresponding to those values. The CSSM_CL_CertGetNextFieldValue 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 certificate query.
A pointer to the CSSM_DATA structure containing the value of the requested field. If the pointer is NULL, an error has occurred. Use CSSM_GetError to obtain the error code.
Invalid Certificate Library Handle.
Invalid results handle.
Not enough memory.
No field values for this results handle.
Unable to get field value.