Edit

Share via

CMSG_MAIL_LIST_RECIPIENT_ENCODE_INFO structure (wincrypt.h)

  • Article

The CMSG_MAIL_LIST_RECIPIENT_ENCODE_INFO structure is used with previously distributed symmetric keys for decrypting the content key encryption key (KEK).

Syntax

typedef struct _CMSG_MAIL_LIST_RECIPIENT_ENCODE_INFO {
  DWORD                       cbSize;
  CRYPT_ALGORITHM_IDENTIFIER  KeyEncryptionAlgorithm;
  void                        *pvKeyEncryptionAuxInfo;
  HCRYPTPROV                  hCryptProv;
  DWORD                       dwKeyChoice;
  union {
    HCRYPTKEY hKeyEncryptionKey;
    void      *pvKeyEncryptionKey;
  } DUMMYUNIONNAME;
  CRYPT_DATA_BLOB             KeyId;
  FILETIME                    Date;
  PCRYPT_ATTRIBUTE_TYPE_VALUE pOtherAttr;
} CMSG_MAIL_LIST_RECIPIENT_ENCODE_INFO, *PCMSG_MAIL_LIST_RECIPIENT_ENCODE_INFO;

Members

cbSize

The size, in bytes, of this data structure.

KeyEncryptionAlgorithm

A CRYPT_ALGORITHM_IDENTIFIER structure that indicates the encryption algorithm used.

pvKeyEncryptionAuxInfo

A pointer to a structure that contains any additional encryption information.

hCryptProv

The provider used to do the recipient key encryption and export. If NULL, the provider specified in CMSG_ENVELOPED_ENCODE_INFO is used.

dwKeyChoice

Indicates which member of the following union will be used. Currently only CMSG_MAIL_LIST_HANDLE_KEY_CHOICE can be used.

DUMMYUNIONNAME

DUMMYUNIONNAME.hKeyEncryptionKey

An HCRYPTKEY value used with the CMSG_MAIL_LIST_HANDLE_KEY_CHOICE value of the dwKeyChoice parameter.

DUMMYUNIONNAME.pvKeyEncryptionKey

A pointer to a void. Reserved for a future potential pointer choice.

KeyId

A CRYPT_DATA_BLOB key identifier of the key-encryption key that was previously distributed to the message sender and one or more recipients.

Date

Optional FILETIME value. When present, specifies a single key encryption key (KEK) from a set that was previously distributed.

pOtherAttr

Optional pointer to a CRYPT_ATTRIBUTE_TYPE_VALUE structure that contains encryption attributes.

Requirements

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