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

A função de retorno de chamada PFN_CMSG_IMPORT_MAIL_LIST importa uma chave de criptografia de conteúdo para um destinatário de transporte de chave de uma mensagem enveloped. PFN_CMSG_IMPORT_MAIL_LIST pode ser instalado usando um identificador de objeto CryptoAPI. Essa função é chamada pela função CryptMsgControl quando seu parâmetro dwCtrlType é definido como CMSG_CTRL_DECRYPT.

Sintaxe

PFN_CMSG_IMPORT_MAIL_LIST PfnCmsgImportMailList;

BOOL PfnCmsgImportMailList(
  [in]  PCRYPT_ALGORITHM_IDENTIFIER pContentEncryptionAlgorithm,
  [in]  PCMSG_CTRL_MAIL_LIST_DECRYPT_PARA pMailListDecryptPara,
  [in]  DWORD dwFlags,
        void *pvReserved,
  [out] HCRYPTKEY *phContentEncryptKey
)
{...}

Parâmetros

[in] pContentEncryptionAlgorithm

Um ponteiro para uma estrutura CRYPT_ALGORITHM_IDENTIFIER que especifica o algoritmo usado para criptografar o conteúdo da mensagem e quaisquer parâmetros associados.

[in] pMailListDecryptPara

Um ponteiro para uma estrutura de CMSG_CTRL_MAIL_LIST_DECRYPT_PARA que contém informações sobre o destinatário da lista de endereçamento.

[in] dwFlags

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

pvReserved

Esse parâmetro é reservado e deve ser NULL.

[out] phContentEncryptKey

O endereço de um identificador para a chave de criptografia de conteúdo retornado por essa função.

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.

Se essa função de retorno de chamada não der suporte ao algoritmo de criptografia de chave, ela deverá retornar FALSE e chamar SetLastError com E_NOTIMPL.

Observações

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.

Requisitos