CSSM_KR_CreateRecoveryRequestContext

Purpose

This call creates a key recovery request context based on a KRSP handle (which determines the key recovery mechanism that is in use). The profile for the local party and flag values to signify what kind of key recovery is desired. A handle to the key recovery request context is returned.

Format

CSSM_CC_HANDLE CSSMAPI CSSM_KR_CreateRecoveryRequestContext 
                  (CSSM_KRSP_HANDLE KRSPHandle,
                  const CSSM_KR_PROFILE_PTR LocalProfile)

Parameters

Input

KRSPHandle: The handle to the KRSP that is used.
LocalProfile: The key recovery profile for the local client. This parameter is relevant only when KRFlags is set to KR_INDIV.

Return Value

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