NAME

CSSM_KR_CreateRecoveryRequestContext

SYNOPSIS

CSSM_CC_HANDLE CSSMAPI CSSM_KR_CreateRecoveryRequestContext
    (CSSM_KRSP_HANDLE KRSPHandle,
    const CSSM_KR_PROFILE LocalProfile)

DESCRIPTION

This call creates a key recovery request context based on a KRSP handle (which determines the key recovery mechanism that is in use) and the profile for the local client. A handle to the key recovery request context is returned.

PARAMETERS

KRSPHandle (input)

The handle to the KRSP that is to be used.

LocalProfile (input)

The key recovery profile for the local client. This parameter is relevant only when the KRFlags value is set to KR_INDIV.

RETURN VALUES

A handle to the key recovery context is returned. If the handle is NULL, it signifies that an error has occurred.

ERRORS

CSSM_INVALID_KR_HANDLE

Invalid handle.

CSSM_KR_INVALID_PROFILE

Invalid profile.

CSSM_MEMORY_ERROR

Memory error.