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

A função de retorno de chamada PFN_CMSG_CNG_IMPORT_CONTENT_ENCRYPT_KEY importa uma CEK (chave de criptografia de conteúdo) já descriptografada. A função PFN_CMSG_CNG_IMPORT_CONTENT_ENCRYPT_KEY pode ser instalada usando uma OID (API de Criptografia: identificador de objeto CNG) de próxima geração.

Sintaxe

PFN_CMSG_CNG_IMPORT_CONTENT_ENCRYPT_KEY PfnCmsgCngImportContentEncryptKey;

BOOL PfnCmsgCngImportContentEncryptKey(
  [in, out] PCMSG_CNG_CONTENT_DECRYPT_INFO pCNGContentDecryptInfo,
  [in]      DWORD dwFlags,
            void *pvReserved
)
{...}

Parâmetros

[in, out] pCNGContentDecryptInfo

Um ponteiro para uma estrutura de CMSG_CNG_CONTENT_DECRYPT_INFO a ser atualizada com o CEK importado. Essa estrutura contém todas as informações relevantes passadas para a função CryptMsgControl .

[in] dwFlags

Esse parâmetro é reservado. Defina-o como zero.

pvReserved

Esse parâmetro é reservado. Defina-o como NULL.

Retornar valor

Se a função for bem-sucedida, o valor retornado será diferente de 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 ERROR_NOT_SUPPORTED.

Comentários

A função CryptMsgControl chama essa função para as seguintes operações especificadas pelo parâmetro dwCtrlType :

CMSG_CTRL_DECRYPT

CMSG_CTRL_KEY_TRANS_DECRYPT

CMSG_CTRL_KEY_AGREE_DECRYPT

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

Exemplos

Para obter um exemplo que implanta uma função de retorno de chamada instalável por OID, consulte Estendendo a funcionalidade de CryptoAPI.

Requisitos

Confira também

Decodificação de dados enveloped