ホーム › Security.Cryptography › PFN_CMSG_IMPORT_MAIL_LIST

PFN_CMSG_IMPORT_MAIL_LIST

コールバック

シグネチャ

BOOL PFN_CMSG_IMPORT_MAIL_LIST(
    CRYPT_ALGORITHM_IDENTIFIER* pContentEncryptionAlgorithm,
    CMSG_CTRL_MAIL_LIST_DECRYPT_PARA* pMailListDecryptPara,
    DWORD dwFlags,
    void* pvReserved,
    UINT_PTR* phContentEncryptKey
);

パラメーター

フィールド	型	説明
pContentEncryptionAlgorithm	CRYPT_ALGORITHM_IDENTIFIER*	メッセージの内容の暗号化に使用されるアルゴリズムと、それに関連するパラメーターを指定する CRYPT_ALGORITHM_IDENTIFIER 構造体へのポインターです。
pMailListDecryptPara	CMSG_CTRL_MAIL_LIST_DECRYPT_PARA*	メーリングリストの受信者に関する情報を格納する CMSG_CTRL_MAIL_LIST_DECRYPT_PARA 構造体へのポインターです。
dwFlags	DWORD	この値は使用されません。0 を設定してください。
pvReserved	void*	このパラメーターは予約されており、NULL でなければなりません。
phContentEncryptKey	UINT_PTR*	この関数が返すコンテンツ暗号化キーのハンドルのアドレスです。

公式ドキュメント

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

戻り値

関数が成功すると、戻り値は 0 以外 (TRUE) です。

関数が失敗すると、戻り値は 0 (FALSE) です。拡張エラー情報を取得するには、GetLastError を呼び出します。

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

解説(Remarks)

このコールバック関数を配置するには、OID サポート関数を使用できます。Wincrypt.h では、この目的のために次の定数が定義されています。

定数	定義
CMSG_OID_IMPORT_MAIL_LIST_FUNC または CMSG_OID_CAPI1_IMPORT_MAIL_LIST_FUNC	"CryptMsgDllImportMailList"

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)