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

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

構文

PFN_CMSG_EXPORT_MAIL_LIST PfnCmsgExportMailList;

BOOL PfnCmsgExportMailList(
  [in]      PCMSG_CONTENT_ENCRYPT_INFO pContentEncryptInfo,
  [in]      PCMSG_MAIL_LIST_RECIPIENT_ENCODE_INFO pMailListEncodeInfo,
  [in, out] PCMSG_MAIL_LIST_ENCRYPT_INFO pMailListEncryptInfo,
  [in]      DWORD dwFlags,
            void *pvReserved
)
{...}

パラメーター

[in] pContentEncryptInfo

コンテンツ暗号化キーを含む CMSG_CONTENT_ENCRYPT_INFO 構造体へのポインター。

[in] pMailListEncodeInfo

コンテンツ暗号化キーの暗号化に使用するキーを指定する CMSG_MAIL_LIST_RECIPIENT_ENCODE_INFO 構造体へのポインター。

[in, out] pMailListEncryptInfo

暗号化されたコンテンツ暗号化キーを含む CMSG_MAIL_LIST_ENCRYPT_INFO 構造体へのポインター。

[in] dwFlags

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

pvReserved

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

戻り値

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

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

備考

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

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

定数	定義
CMSG_OID_EXPORT_MAIL_LIST_FUNCまたはCMSG_OID_CAPI1_EXPORT_MAIL_LIST_FUNC	"CryptMsgDllExportMailList"

必要条件

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