CMSG_CMS_RECIPIENT_INFO structure

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;
  };
} 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

 

pKeyTrans

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

pKeyAgree

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

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