CMSG_MAIL_LIST_ENCRYPT_INFO Struktur (wincrypt.h)

Artikel
07/16/2024

Die CMSG_MAIL_LIST_ENCRYPT_INFO-Struktur enthält Verschlüsselungsinformationen für einen Adresslistenempfänger von umschlagten Daten. Die PFN_CMSG_EXPORT_MAIL_LIST-Funktion aktualisiert diese Struktur.

Syntax

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;

Angehörige

cbSize

Die Größe dieser Struktur in Byte.

dwRecipientIndex

Ein Wert, der die Ordnungszahl eines Empfängers in der Empfängerliste angibt, die durch die pContentEncryptInfo Parameter für die PFN_CMSG_EXPORT_MAIL_LIST-Funktion angegeben wird.

KeyEncryptionAlgorithm

Eine CRYPT_ALGORITHM_IDENTIFIER Struktur, die den Algorithmus angibt, der zum Verschlüsseln des Inhaltsverschlüsselungsschlüssels verwendet wird. Die CryptMsgOpenToEncode--Funktion verwendet die pszObjId Member der CRYPT_ALGORITHM_IDENTIFIER-Struktur, um die Adresse der Funktion abzurufen, die zum Exportieren des Schlüssels verwendet wird. Die Funktion kann mithilfe einer Kryptografie-API installiert werden: Next Generation (CNG) Objektbezeichner (OID).

EncryptedKey

Eine CRYPT_DATA_BLOB Struktur, die den verschlüsselten Sitzungsschlüssel enthält.

dwFlags

Ein Wert, der angibt, welche Elemente aktualisiert wurden und deren Speicherzuweisung mithilfe der CryptMsgOpenToEncode- funktion freigegeben werden muss.

Wert	Bedeutung
CMSG_MAIL_LIST_ENCRYPT_FREE_OBJID_FLAG 0x00000002	Das pszObjId Mitglied der CRYPT_ALGORITHM_IDENTIFIER Struktur, auf die KeyEncryptionAlgorithm verweist, Mitglied aktualisiert wurde.
CMSG_MAIL_LIST_ENCRYPT_FREE_PARA_FLAG 0x00000001	Das ParameterspbData Member der CRYPT_ALGORITHM_IDENTIFIER Struktur, auf die durch das KeyEncryptionAlgorithm Member verwiesen wird, wurde aktualisiert.

Bemerkungen

Beim Aufruf mit dem dwMsgType Parameter, der auf CMSG_ENVELOPEDfestgelegt ist, initialisiert die CryptMsgOpenToEncode-Funktion die CMSG_MAIL_LIST_ENCRYPT_INFO Struktur aus der CMSG_MAIL_LIST_RECIPIENT_ENCODE_INFO-Struktur. Die CryptMsgOpenToEncode--Funktion ruft die PFN_CMSG_EXPORT_MAIL_LIST-Funktion auf, um die CMSG_MAIL_LIST_ENCRYPT_INFO Struktur zu aktualisieren. Wenn die Rückruffunktion nicht gefunden werden kann, füllt die CryptMsgOpenToEncode--Funktion diese Struktur mit Standardschlüsselinformationen aus der CMSG_CONTENT_ENCRYPT_INFO-Struktur aus.

Die folgenden Elemente der CMSG_MAIL_LIST_ENCRYPT_INFO-Struktur können von der Rückruffunktion aktualisiert werden:

EncryptedKey-

KeyEncryptionAlgorithm.pszObjId

KeyEncryptionAlgorithm.Parameters

dwFlags-

Die anderen Member sind schreibgeschützt.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Header-	wincrypt.h

Siehe auch

Codieren von Umschlagdaten

Freigeben über