PFN_CMSG_CNG_IMPORT_CONTENT_ENCRYPT_KEY コールバック関数 (wincrypt.h)
PFN_CMSG_CNG_IMPORT_CONTENT_ENCRYPT_KEY コールバック関数は、既に復号化されたコンテンツ暗号化キー (CEK) をインポートします。 PFN_CMSG_CNG_IMPORT_CONTENT_ENCRYPT_KEY関数は、Cryptography API: Next Generation (CNG) オブジェクト識別子 (OID) を使用してインストールできます。
構文
PFN_CMSG_CNG_IMPORT_CONTENT_ENCRYPT_KEY PfnCmsgCngImportContentEncryptKey;
BOOL PfnCmsgCngImportContentEncryptKey(
[in, out] PCMSG_CNG_CONTENT_DECRYPT_INFO pCNGContentDecryptInfo,
[in] DWORD dwFlags,
void *pvReserved
)
{...}
パラメーター
[in, out] pCNGContentDecryptInfo
インポートされた CEK で更新される CMSG_CNG_CONTENT_DECRYPT_INFO 構造体へのポインター。 この構造体には、 CryptMsgControl 関数に渡されるすべての関連情報が含まれます。
[in] dwFlags
このパラメーターは予約されています。 0 に設定します。
pvReserved
このパラメーターは予約されています。 これを NULL に設定します。
戻り値
関数が成功した場合、戻り値は 0 以外 (TRUE) になります。
関数が失敗した場合、戻り値は 0 (FALSE) になります。 拡張エラー情報については、 GetLastError を呼び出します。
このコールバック関数がキー暗号化アルゴリズムをサポートしていない場合は、 FALSE を 返し、ERROR_NOT_SUPPORTEDを使用して SetLastError を呼び出す必要があります。
注釈
CryptMsgControl 関数は、dwCtrlType パラメーターで指定された次の操作に対してこの関数を呼び出します。
- CMSG_CTRL_DECRYPT
- CMSG_CTRL_KEY_TRANS_DECRYPT
- CMSG_CTRL_KEY_AGREE_DECRYPT
OID サポート関数を使用して、このコールバック関数を展開できます。 Wincrypt.h は、この目的のために次の定数を定義します。
| 常時 | 定義 |
|---|---|
| CMSG_OID_CNG_IMPORT_CONTENT_ENCRYPT_KEY_FUNC | "CryptMsgDllCNGImportContentEncryptKey" |
例
OID インストール可能なコールバック関数を展開する例については、「 CryptoAPI 機能の拡張」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | wincrypt.h |