CSSM_RETURN CSSMKRSPI KRSP_RecoveryRetrieve (CSSM_KRSP_HANDLE KRSPHandle, CSSM_HANDLE ReferenceHandle, uint32 *EstimatedTime, CSSM_HANDLE_PTR CacheHandle, uint32 *NumberOfResults)
This function completes a key recovery request operation. The ReferenceHandle parameter indicates which outstanding recovery request is to be completed. The results of a successful recovery operation are referenced by the CacheHandle parameter, which may be used with the KRSP_GetRecoveredObject function to retrieve the recovered keys.
If the results are not available at the time this function is invoked, the CacheHandle is NULL, and the EstimatedTime parameter indicates when this operation should be repeated with the same ReferenceHandle.
- KRSPHandle (input)
The handle that describes the add-in key recovery service provider module used to perform up calls to CSSM for the memory functions managed by CSSM.
- ReferenceHandle (input)
Handle that indicates which key recovery request operation is to be completed.
- EstimatedTime (output)
The estimated time after which this call should be repeated to obtain recovery results. This is set to a non-zero value only when the ResultsHandle parameter is NULL.
- CacheHandle (output)
Handle returned when recovery operation is successful. This handle may be used to get individual keys using the KRSP_GetRecoveredObject function. This handle is NULL, if EstimatedTime parameter is not zero.
- NumberOfResults (output)
The number of recovered key objects that may be obtained using the ResultsHandle.
A CSSM return value. This function returns CSSM_OK if successful and returns an error code if an error has occurred.
Invalid KR handle.
Invalid reference handle.