This function completes a key recovery registration operation. The results of a successful registration operation are returned through the KRProfile parameter, which may be used with the profile management API functions.

If the results are not available when this function is invoked, the KRProfile parameter is set to NULL, and the EstimatedTime parameter indicates when this operation should be repeated with the same ReferenceHandle.

CSSM_RETURN CSSMAPI CSSM_KR_RegistrationRetrieve
               (CSSM_KRSP_HANDLE hKRSP,
               CSSM_HANDLE ReferenceHandle,
               unit32 *EstimatedTime, 
               CSSM_KR_PROFILE_PTR KRProfile)

Input

hKRSP

The handle to the KRSP that will be used.

ReferenceHandle

The handle to the key recovery registration request that will be completed.

Output

EstimatedTime

The estimated time after which this call should be repeated to obtain registration results. This is set to a non-zero value only when the KRProfile parameter is NULL.

Input/Output

KRProfile

Key recovery profile that is filled in by the registration operation.

CSSM_OK if successful, CSSM_FAIL if an error occurred. Use CSSM_GetError to determine the exact error.