NAME

CSSM_KR_RegistrationRetrieve

SYNOPSIS

CSSM_RETURN CSSMAPI CSSM_KR_RegistrationRetrieve
    (CSSM_KRSP_HANDLE KRSPHandle,
    CSSM_HANDLE ReferenceHandle
    uint32 *EstimatedTime
    CSSM_KR_PROFILE_PTR KRProfile)

DESCRIPTION

This function completes a key recovery registration operation by returning the profile information generated as a result of a successful key recovery registration process. It is possible that the key recovery registration process has not yet completed. In this case, the returned EstimatedTime is the updated estimate for completion of the registration procedure. If the profile pointer is NULL and the estimated time is greater than zero, the caller should repeat this call after the specified time to retrieve the profile structure.

PARAMETERS

KRSPHandle (input)

The handle of the KR module to perform this operation.

ReferenceHandle (input)

The handle that specifies the corresponding call to CSSM_KR_RegistrationRequest, which initiated the key recovery registration procedure.

EstimatedTime (output)

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 result is NULL.

KRProfile (output)

The key recovery profile that is filled in by the registration operation.

RETURN VALUES

A CSSM return value. This function returns CSSM_OK if successful and returns an error code if an error has occurred.

ERRORS

CSSM_KR_INVALID_HANDLE

Invalid reference handle.

CSSM_MEMORY_ERROR

Memory error.