CMSG_MAIL_LIST_ENCRYPT_INFO 構造体 (wincrypt.h)

  • [アーティクル]

CMSG_MAIL_LIST_ENCRYPT_INFO構造には、封筒データのメーリング リスト受信者の暗号化情報が含まれています。 PFN_CMSG_EXPORT_MAIL_LIST関数は、この構造体を更新します。

構文

typedef struct _CMSG_MAIL_LIST_ENCRYPT_INFO {
  DWORD                      cbSize;
  DWORD                      dwRecipientIndex;
  CRYPT_ALGORITHM_IDENTIFIER KeyEncryptionAlgorithm;
  CRYPT_DATA_BLOB            EncryptedKey;
  DWORD                      dwFlags;
} CMSG_MAIL_LIST_ENCRYPT_INFO, *PCMSG_MAIL_LIST_ENCRYPT_INFO;

メンバー

cbSize

この構造体のサイズ (バイト単位)。

dwRecipientIndex

pContentEncryptInfo パラメーターで指定された受信者リスト内の受信者の序数を、PFN_CMSG_EXPORT_MAIL_LIST関数に指定する値です。

KeyEncryptionAlgorithm

コンテンツ暗号化キーの暗号化に使用されるアルゴリズムを指定する CRYPT_ALGORITHM_IDENTIFIER 構造体。 CryptMsgOpenToEncode 関数は、CRYPT_ALGORITHM_IDENTIFIER構造体の pszObjId メンバーを使用して、キーのエクスポートに使用される関数のアドレスを取得します。 関数は、Cryptography API: Next Generation (CNG) オブジェクト識別子 (OID) を使用してインストールできます。

EncryptedKey

暗号化されたセッション キーを含む CRYPT_DATA_BLOB 構造体。

dwFlags

更新されたメンバーと、 CryptMsgOpenToEncode 関数を使用して解放する必要があるメモリ割り当てを指定する値。

値 説明
CMSG_MAIL_LIST_ENCRYPT_FREE_OBJID_FLAG
0x00000002
 KeyEncryptionAlgorithm メンバーによって参照されるCRYPT_ALGORITHM_IDENTIFIER構造体の pszObjId メンバーが更新されました。
CMSG_MAIL_LIST_ENCRYPT_FREE_PARA_FLAG
0x00000001
 KeyEncryptionAlgorithm メンバーによって参照されるCRYPT_ALGORITHM_IDENTIFIER構造体の ParameterspbData メンバーが更新されました。

解説

dwMsgType パラメーターを CMSG_ENVELOPED に設定して呼び出すと、CryptMsgOpenToEncode 関数は、CMSG_MAIL_LIST_RECIPIENT_ENCODE_INFO構造体からCMSG_MAIL_LIST_ENCRYPT_INFO構造体を初期化します。 CryptMsgOpenToEncode 関数は、PFN_CMSG_EXPORT_MAIL_LIST関数を呼び出して、CMSG_MAIL_LIST_ENCRYPT_INFO構造体を更新します。 コールバック関数が見つからない場合、 CryptMsgOpenToEncode 関数は、この構造体に CMSG_CONTENT_ENCRYPT_INFO 構造体からの既定のキー情報を入力します。

CMSG_MAIL_LIST_ENCRYPT_INFO構造体の次のメンバーは、コールバック関数によって更新できます。

EncryptedKey
KeyEncryptionAlgorithm.pszObjId
KeyEncryptionAlgorithm.Parameters
dwFlags

他のメンバーは読み取り専用です。

要件

   
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
Header wincrypt.h

関連項目

エンベロープ データのエンコード