CMSG_KEY_TRANS_ENCRYPT_INFO Struktur (wincrypt.h)
Die CMSG_KEY_TRANS_ENCRYPT_INFO-Struktur enthält Verschlüsselungsinformationen für einen Schlüsseltransportempfänger von umhüllten Daten. Die PFN_CMSG_EXPORT_KEY_TRANS-Funktion aktualisiert diese Struktur.
Syntax
typedef struct _CMSG_KEY_TRANS_ENCRYPT_INFO {
DWORD cbSize;
DWORD dwRecipientIndex;
CRYPT_ALGORITHM_IDENTIFIER KeyEncryptionAlgorithm;
CRYPT_DATA_BLOB EncryptedKey;
DWORD dwFlags;
} CMSG_KEY_TRANS_ENCRYPT_INFO, *PCMSG_KEY_TRANS_ENCRYPT_INFO;
Member
cbSize
Die Größe (in Bytes) dieser Struktur.
dwRecipientIndex
Ein Wert, der die Ordnungszahl eines Empfängers in der Empfängerliste angibt, die durch den pContentEncryptInfo-Parameter der PFN_CMSG_EXPORT_KEY_TRANS-Funktion angegeben wird.
KeyEncryptionAlgorithm
Eine CRYPT_ALGORITHM_IDENTIFIER-Struktur , die den Algorithmus des öffentlichen Empfängerschlüssels angibt. Die CryptMsgOpenToEncode-Funktion verwendet das pszObjId-Element 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: CNG-Objektbezeichner (OID) der nächsten Generation.
EncryptedKey
Eine CRYPT_DATA_BLOB-Struktur , die den Sitzungsschlüssel enthält, der durch den öffentlichen Schlüssel des Empfängers verschlüsselt wurde.
dwFlags
Ein Wert, der angibt, welche Member aktualisiert wurden und deren Speicherbelegung mithilfe der CryptMsgOpenToEncode-Funktion freigegeben werden muss.
Wert | Bedeutung |
---|---|
|
Das pszObjId-Element der CRYPT_ALGORITHM_IDENTIFIER Struktur, auf die vom KeyEncryptionAlgorithm-Member verwiesen wird, wurde aktualisiert. |
|
Das ParameterpbData-Element der CRYPT_ALGORITHM_IDENTIFIER Struktur, auf die vom KeyEncryptionAlgorithm-Member verwiesen wird, wurde aktualisiert. |
Hinweise
Wenn der dwMsgType-Parameter auf CMSG_ENVELOPED festgelegt ist, initialisiert die CryptMsgOpenToEncode-Funktion die CMSG_KEY_TRANS_ENCRYPT_INFO-Struktur aus der CMSG_KEY_TRANS_RECIPIENT_ENCODE_INFO-Struktur . Die Funktion CryptMsgOpenToEncode ruft die PFN_CMSG_EXPORT_KEY_TRANS-Funktion auf, um die CMSG_KEY_TRANS_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_KEY_TRANS_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 |
---|---|
Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
Kopfzeile | wincrypt.h |