This function performs a key recovery registration operation. The KRInData parameter contains known input parameters for the recovery registration operation. A UserCallback function may be supplied to allow the registration operation to interact with the user interface, if necessary. When this operation is successful, a ReferenceHandle and an EstimatedTime parameter are returned; the ReferenceHandle will be used to invoke the CSSM_KR_RegistrationRetrieve function, after the EstimatedTime in seconds.

CSSM_RETURN CSSMAPI CSSM_KR_RegistrationRequest
               (CSSM_CC_HANDLE RecoveryRegistrationContext,
               CSSM_DATA_PTR KRInData,
               CSSM_CRYPTO_DATA_PTR UserCallback,
               uint8 KRFlags,
               unit32 *EstimatedTime, 
               CSSM_HANDLE_PTR ReferenceHandle)

Input

RecoveryRegistrationContext

The handle to the key recovery registration context.

KRInData

Input data for key recovery registration.

UserCallBack

A callback function that may be used to collect further information from the user interface.

KRFlags

Flag values for recovery registration. Defined values are:

• KR_INDIVIDUAL - signifies that the registration is for the IND scenario
• KR_ENT - signifies that the registration is for the ENT scenario
• KR_LE - signifies that the registration is for the LE scenario

Output

EstimatedTime

The estimated time after which the CSSM_KR_RegistrationRetrieve call should be invoked to obtain registration results.

ReferenceHandle

The handle to use to invoke the CSSM_KR_RegistrationRetrieve function.

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