estrutura CMSG_MAIL_LIST_ENCRYPT_INFO (wincrypt.h)

Artigo
07/16/2024

A estrutura CMSG_MAIL_LIST_ENCRYPT_INFO contém informações de criptografia para um destinatário de lista de endereçamento de dados enveloped. A função PFN_CMSG_EXPORT_MAIL_LIST atualiza essa estrutura.

Sintaxe

typedef struct _CMSG_MAIL_LIST_ENCRYPT_INFO {
  DWORD                      cbSize;
  DWORD                      dwRecipientIndex;
  CRYPT_ALGORITHM_IDENTIFIER KeyEncryptionAlgorithm;
  CRYPT_DATA_BLOB            EncryptedKey;
  DWORD                      dwFlags;
} CMSG_MAIL_LIST_ENCRYPT_INFO, *PCMSG_MAIL_LIST_ENCRYPT_INFO;

Membros

cbSize

O tamanho, em bytes, dessa estrutura.

dwRecipientIndex

Um valor que especifica o número ordinal de um destinatário na lista de destinatários especificada pelo parâmetro pContentEncryptInfo para a função PFN_CMSG_EXPORT_MAIL_LIST.

KeyEncryptionAlgorithm

Uma estrutura CRYPT_ALGORITHM_IDENTIFIER que especifica o algoritmo usado para criptografar a chave de criptografia de conteúdo. A função CryptMsgOpenToEncode usa o membro pszObjId da estrutura CRYPT_ALGORITHM_IDENTIFIER para obter o endereço da função usada para exportar a chave. A função pode ser instalada usando uma API de Criptografia: CNG (Próxima Geração) identificador de objeto (OID).

EncryptedKey

Uma estrutura CRYPT_DATA_BLOB que contém a chave de sessão criptografada.

dwFlags

Um valor que especifica quais membros foram atualizados e cuja alocação de memória deve ser liberada usando a função CryptMsgOpenToEncode.

Valor	Significado
CMSG_MAIL_LIST_ENCRYPT_FREE_OBJID_FLAG 0x00000002	O membro pszObjId da estrutura CRYPT_ALGORITHM_IDENTIFIER referenciada pelo membro KeyEncryptionAlgorithm foi atualizado.
CMSG_MAIL_LIST_ENCRYPT_FREE_PARA_FLAG 0x00000001	Os parâmetros membro pbData da estrutura CRYPT_ALGORITHM_IDENTIFIER referenciada pelo membro KeyEncryptionAlgorithm foi atualizado.

Observações

Quando chamado com o parâmetro dwMsgType definido como CMSG_ENVELOPED, a função CryptMsgOpenToEncode inicializa a estrutura CMSG_MAIL_LIST_ENCRYPT_INFO da estrutura CMSG_MAIL_LIST_RECIPIENT_ENCODE_INFO. A função CryptMsgOpenToEncode chama a função PFN_CMSG_EXPORT_MAIL_LIST para atualizar a estrutura CMSG_MAIL_LIST_ENCRYPT_INFO. Se a função de retorno de chamada não puder ser encontrada, a função CryptMsgOpenToEncode preencherá essa estrutura com informações de chave padrão da estrutura CMSG_CONTENT_ENCRYPT_INFO.

Os seguintes membros da estrutura CMSG_MAIL_LIST_ENCRYPT_INFO podem ser atualizados pela função de retorno de chamada:

EncryptedKey

KeyEncryptionAlgorithm.pszObjId

KeyEncryptionAlgorithm.Parameters

dwFlags

Os outros membros são somente leitura.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows XP [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
cabeçalho	wincrypt.h

Consulte também

codificação de dados envelopes

Compartilhar via