Edit

Share via

CMSG_CMS_RECIPIENT_INFO structure (wincrypt.h)

  • Article

The CMSG_CMS_RECIPIENT_INFO structure is used with the CryptMsgGetParam function to get information on a key transport, key agreement, or mail list envelope message recipient. This structure is returned in pvData when CryptMsgGetParam is called with dwParamType set to CMSG_CMS_RECIPIENT_INFO_PARAM.

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;

Members

dwRecipientChoice

Indicates the member of the union to be used.

Possible values are:

Value Meaning
CMSG_KEY_TRANS_RECIPIENT
 pKeyTrans
CMSG_KEY_AGREE_RECIPIENT
 pKeyAgree
CMSG_MAIL_LIST_RECIPIENT
 pMailList

DUMMYUNIONNAME

DUMMYUNIONNAME.pKeyTrans

A pointer to a CMSG_KEY_TRANS_RECIPIENT_INFO structure that identifies a key transport recipient. Used for RSA recipients.

DUMMYUNIONNAME.pKeyAgree

A pointer to a CMSG_KEY_AGREE_RECIPIENT_INFO structure that identifies a key agreement recipient. Used for Diffie-Hellman recipients.

DUMMYUNIONNAME.pMailList

A pointer to a CMSG_MAIL_LIST_RECIPIENT_INFO structure that identifies a recipient using a previously distributed key encryption key for the encryption/decryption of the envelopes message's symmetric key.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Header wincrypt.h