PFN_CMSG_IMPORT_KEY_AGREEコールバック関数 (wincrypt.h)

PFN_CMSG_IMPORT_KEY_AGREE コールバック関数は、エンベロープ メッセージのキー トランスポート受信者のコンテンツ暗号化キーをインポートします。 PFN_CMSG_IMPORT_KEY_AGREE は、CryptoAPIオブジェクト識別子 (OID) を使用してインストールできます。 この関数は、dwCtrlType パラメーターが CMSG_CTRL_DECRYPTに設定されている場合に、CryptMsgControl 関数によって呼び出されます。

構文

PFN_CMSG_IMPORT_KEY_AGREE PfnCmsgImportKeyAgree;

BOOL PfnCmsgImportKeyAgree(
  [in]  PCRYPT_ALGORITHM_IDENTIFIER pContentEncryptionAlgorithm,
  [in]  PCMSG_CTRL_KEY_AGREE_DECRYPT_PARA pKeyAgreeDecryptPara,
  [in]  DWORD dwFlags,
        void *pvReserved,
  [out] HCRYPTKEY *phContentEncryptKey
)
{...}

パラメーター

[in] pContentEncryptionAlgorithm

メッセージの内容と関連するパラメーターの暗号化に使用するアルゴリズムを指定する CRYPT_ALGORITHM_IDENTIFIER 構造体へのポインター。

[in] pKeyAgreeDecryptPara

キー 契約の受信者に関する情報を含む CMSG_CTRL_KEY_AGREE_DECRYPT_PARA 構造体へのポインター。

[in] dwFlags

この値は使用されません。 0 に設定します。

pvReserved

このパラメーターは予約されており、NULLする必要があります。

[out] phContentEncryptKey

この関数によって返されるコンテンツ暗号化キーへのハンドルのアドレス。

戻り値

関数が成功した場合、戻り値は 0 以外 (true)。

関数が失敗した場合、戻り値は 0 (FALSE)。 拡張エラー情報については、GetLastError呼び出します。

このコールバック関数がキー暗号化アルゴリズムをサポートしていない場合は、FALSE 返し、E_NOTIMPLで SetLastError 呼び出す必要があります。

備考

OID サポート関数 を使用して、このコールバック関数を展開できます。 Wincrypt.h は、この目的のために次の定数を定義します。

定数	定義
CMSG_OID_IMPORT_KEY_AGREE_FUNCまたはCMSG_OID_CAPI1_IMPORT_KEY_AGREE_FUNC	"CryptMsgDllImportKeyAgree"

必要条件

要件	価値
サポートされる最小クライアント	Windows XP [デスクトップ アプリのみ]
サポートされる最小サーバー	Windows Server 2003 [デスクトップ アプリのみ]
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	wincrypt.h