Win32 API 日本語リファレンス
ホーム › Security.Cryptography › PFN_CMSG_EXPORT_MAIL_LIST

PFN_CMSG_EXPORT_MAIL_LIST

コールバック

シグネチャ

BOOL PFN_CMSG_EXPORT_MAIL_LIST(
    CMSG_CONTENT_ENCRYPT_INFO* pContentEncryptInfo,
    CMSG_MAIL_LIST_RECIPIENT_ENCODE_INFO* pMailListEncodeInfo,
    CMSG_MAIL_LIST_ENCRYPT_INFO* pMailListEncryptInfo,
    DWORD dwFlags,
    void* pvReserved
);

パラメーター

フィールド型説明
pContentEncryptInfoCMSG_CONTENT_ENCRYPT_INFO*コンテンツ暗号化キーを格納する CMSG_CONTENT_ENCRYPT_INFO 構造体へのポインターです。
pMailListEncodeInfoCMSG_MAIL_LIST_RECIPIENT_ENCODE_INFO*コンテンツ暗号化キーの暗号化に使用するキーを指定する CMSG_MAIL_LIST_RECIPIENT_ENCODE_INFO 構造体へのポインターです。
pMailListEncryptInfoCMSG_MAIL_LIST_ENCRYPT_INFO*暗号化されたコンテンツ暗号化キーを格納する CMSG_MAIL_LIST_ENCRYPT_INFO 構造体へのポインターです。
dwFlagsDWORDこの値は使用されません。0 を設定してください。
pvReservedvoid*このパラメーターは予約されており、NULL を指定する必要があります。

公式ドキュメント

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

戻り値

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

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

解説(Remarks)

PFN_CMSG_EXPORT_MAIL_LIST 関数は、pMailListEncryptInfo パラメーターが指す CMSG_MAIL_LIST_ENCRYPT_INFO 構造体の EncryptedKey メンバーを更新する必要があります。また、この関数が更新する値のメモリ管理には、pContentEncryptInfo パラメーターが指す CMSG_CONTENT_ENCRYPT_INFO 構造体の pfnAlloc メンバーと pfnFree メンバーを使用する必要があります。

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

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