NAME

CL_CertAbortQuery

SYNOPSIS

CSSM_RETURN CSSMCLI CL_CertAbortQuery
    (CSSM_CL_HANDLE CLHandle,
    CSSM_HANDLE ResultsHandle)

DESCRIPTION

This function terminates the get operation initiated by CSSM_CL_CertGetFirstFieldValue and allows the CL to release all intermediate state information associated with the query. This function should be called even if all values retrieved by the call to CSSM_CL_CertGetFirstFieldValue are obtained by repeated calls to CSSM_CL_CertGetNextFieldValue.

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 certificate query.

RETURN VALUE

CSSM_OK if the function was successful. CSSM_FAIL if an error condition occurred. Use CSSM_GetError to obtain the error code.

ERRORS

CSSM_CL_INVALID_CL_HANDLE

Invalid Certificate Library Handle.

CSSM_CL_INVALID_RESULTS_HANDLE

Invalid results handle.

CSSM_CL_CERT_ABORT_QUERY_FAIL

Unable to abort query.

SEE ALSO

CL_CertGetFirstFieldValue, CL_CertGetNextFieldValue