PFN_CMSG_EXPORT_MAIL_LIST função de retorno de chamada (wincrypt.h)

Artigo
07/16/2024

A função de retorno de chamada PFN_CMSG_EXPORT_MAIL_LIST criptografa e exporta a chave de criptografia de conteúdo para um destinatário de lista de endereçamento de uma mensagem enveloped. PFN_CMSG_EXPORT_MAIL_LIST pode ser instalado usando um OID (identificador de objetoCryptoAPI). Essa função é chamada pela função CryptMsgOpenToEncode quando seu parâmetro dwMsgType é definido como CMSG_ENVELOPED.

Sintaxe

PFN_CMSG_EXPORT_MAIL_LIST PfnCmsgExportMailList;

BOOL PfnCmsgExportMailList(
  [in]      PCMSG_CONTENT_ENCRYPT_INFO pContentEncryptInfo,
  [in]      PCMSG_MAIL_LIST_RECIPIENT_ENCODE_INFO pMailListEncodeInfo,
  [in, out] PCMSG_MAIL_LIST_ENCRYPT_INFO pMailListEncryptInfo,
  [in]      DWORD dwFlags,
            void *pvReserved
)
{...}

Parâmetros

[in] pContentEncryptInfo

Um ponteiro para uma estrutura CMSG_CONTENT_ENCRYPT_INFO que contém a chave de criptografia de conteúdo.

[in] pMailListEncodeInfo

Um ponteiro para uma estrutura de CMSG_MAIL_LIST_RECIPIENT_ENCODE_INFO que especifica a chave usada para criptografar a chave de criptografia de conteúdo.

[in, out] pMailListEncryptInfo

Um ponteiro para uma estrutura de CMSG_MAIL_LIST_ENCRYPT_INFO que contém a chave de criptografia de conteúdo criptografada.

[in] dwFlags

Esse valor não é usado. Defina-o como zero.

pvReserved

Esse parâmetro é reservado e deve ser NULL.

Valor de retorno

Se a função for bem-sucedida, o valor retornado não será zero (TRUE).

Se a função falhar, o valor retornado será zero (false). Para obter informações de erro estendidas, chame GetLastError.

Observações

A função PFN_CMSG_EXPORT_MAIL_LIST deve atualizar o membro EncryptedKey da estrutura CMSG_MAIL_LIST_ENCRYPT_INFO apontada pelo parâmetro pMailListEncryptInfo . Essa função deve usar os pfnAlloc e membros pfnFree da estrutura CMSG_CONTENT_ENCRYPT_INFO apontada pelo parâmetro pContentEncryptInfo para gerenciar a memória de todos os valores que ele atualiza.

Você pode usar funções de suporte de OID para implantar essa função de retorno de chamada. Wincrypt.h define as seguintes constantes para essa finalidade.

Constante	Definição
CMSG_OID_EXPORT_MAIL_LIST_FUNC ou CMSG_OID_CAPI1_EXPORT_MAIL_LIST_FUNC	"CryptMsgDllExportMailList"

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]
da Plataforma de Destino	Windows
cabeçalho	wincrypt.h

Compartilhar via