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 メンバーを更新する必要があります。 この関数は、pContentEncryptInfo パラメーターが指すCMSG_CONTENT_ENCRYPT_INFO構造体の pfnAlloc メンバーと pfnFree メンバーを使用して、更新されるすべての値のメモリを管理する必要があります。

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

常時	定義
CMSG_OID_EXPORT_MAIL_LIST_FUNCまたはCMSG_OID_CAPI1_EXPORT_MAIL_LIST_FUNC	"CryptMsgDllExportMailList"

要件

要件	値
サポートされている最小のクライアント	Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム	Windows
ヘッダー	wincrypt.h