CMSG_CMS_RECIPIENT_INFO-Struktur (wincrypt.h)

Die CMSG_CMS_RECIPIENT_INFO-Struktur wird mit der CryptMsgGetParam-Funktion verwendet, um Informationen über einen Schlüsseltransport, eine Schlüsselvereinbarung oder einen E-Mail-Listenumschlag-Nachrichtenempfänger abzurufen. Diese Struktur wird in pvData zurückgegeben, wenn CryptMsgGetParam aufgerufen wird, wobei dwParamType auf CMSG_CMS_RECIPIENT_INFO_PARAM festgelegt ist.

Syntax

typedef struct _CMSG_CMS_RECIPIENT_INFO {
  DWORD dwRecipientChoice;
  union {
    PCMSG_KEY_TRANS_RECIPIENT_INFO pKeyTrans;
    PCMSG_KEY_AGREE_RECIPIENT_INFO pKeyAgree;
    PCMSG_MAIL_LIST_RECIPIENT_INFO pMailList;
  } DUMMYUNIONNAME;
} CMSG_CMS_RECIPIENT_INFO, *PCMSG_CMS_RECIPIENT_INFO;

Member

dwRecipientChoice

Gibt den Member der union an, die verwendet werden soll.

Mögliche Werte:

Wert	Bedeutung
CMSG_KEY_TRANS_RECIPIENT	pKeyTrans
CMSG_KEY_AGREE_RECIPIENT	pKeyAgree
CMSG_MAIL_LIST_RECIPIENT	pMailList

DUMMYUNIONNAME

DUMMYUNIONNAME.pKeyTrans

Ein Zeiger auf eine CMSG_KEY_TRANS_RECIPIENT_INFO-Struktur , die einen Schlüsseltransportempfänger identifiziert. Wird für RSA-Empfänger verwendet.

DUMMYUNIONNAME.pKeyAgree

Ein Zeiger auf eine CMSG_KEY_AGREE_RECIPIENT_INFO-Struktur , die einen Schlüsselvertragsempfänger identifiziert. Wird für Diffie-Hellman Empfänger verwendet.

DUMMYUNIONNAME.pMailList

Ein Zeiger auf eine CMSG_MAIL_LIST_RECIPIENT_INFO-Struktur , die einen Empfänger mithilfe eines zuvor verteilten Schlüsselverschlüsselungsschlüssels für die Ver-/Entschlüsselung des symmetrischen Schlüssels der Umschläge-Nachricht identifiziert.

Anforderungen

Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	wincrypt.h