CMSG_CMS_RECIPIENT_INFO (Compact 2013)

3/28/2014

This 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	Description
  CMSG_KEY_TRANS_RECIPIENT	pKeyTrans
  CMSG_KEY_AGREE_RECIPIENT	pKeyAgree
  CMSG_MAIL_LIST_RECIPIENT	pMailList

• pKeyTrans
  Pointer to a CMSG_KEY_TRANS_RECIPIENT_INFO structure identifying a key transport recipient. Used for RSA recipients.

• pKeyAgree
  Pointer to a CMSG_KEY_AGREE_RECIPIENT_INFO structure identifying a key agreement recipient. Used for Diffie Hellman recipients

• pMailList
  Pointer to a CMSG_MAIL_LIST_RECIPIENT_INFO structure identifying a recipient using a previously distributed key encryption key for the encryption/decryption of the envelopes message's symmetric key.

Requirements

Header

wincrypt.h

See Also

Reference

Cryptography Structures