Função CryptDecrypt (wincrypt.h)

Alterações importantes para dar suporte a interoperabilidade de email do de Email seguro/multiuso (S/MIME) foram feitas no CryptoAPI que afetam o tratamento de mensagens envolvidas. Para obter mais informações, consulte a seção Comentários de CryptMsgOpenToEncode.

Sintaxe

BOOL CryptDecrypt(
  [in]      HCRYPTKEY  hKey,
  [in]      HCRYPTHASH hHash,
  [in]      BOOL       Final,
  [in]      DWORD      dwFlags,
  [in, out] BYTE       *pbData,
  [in, out] DWORD      *pdwDataLen
);

Parâmetros

[in] hKey

Um identificador para a chave a ser usada para a descriptografia. Um aplicativo obtém esse identificador usando a função CryptGenKey ou CryptImportKey.

Essa chave especifica o algoritmo de descriptografia a ser usado.

[in] hHash

Um identificador para um objeto de hash . Se os dados forem descriptografados e hash simultaneamente, um identificador para um objeto hash será passado nesse parâmetro. O valor de hash é atualizado com ode texto sem formatação descriptografado. Essa opção é útil ao descriptografar e verificar simultaneamente uma assinatura.

Antes de chamar CryptDecrypt, o aplicativo deve obter um identificador para o objeto hash chamando a função CryptCreateHash. Depois que a descriptografia for concluída, o valor de hash poderá ser obtido usando a função CryptGetHashParam, ele também pode ser assinado usando a função CryptSignHash ou pode ser usado para verificar uma assinatura digital usando a função CryptVerifySignature.

Se nenhum hash for feito, esse parâmetro deverá ser zero.

[in] Final

Um valor booliano que especifica se esta é a última seção de uma série que está sendo descriptografada. Esse valor será VERDADEIRO se esse for o último ou único bloco. Se este não for o último bloco, esse valor será false. Para obter mais informações, consulte Comentários.

[in] dwFlags

Os valores de sinalizador a seguir são definidos.

[in, out] pbData

Um ponteiro para um buffer que contém os dados a serem descriptografados. Depois que a descriptografia for executada, o texto sem formatação será colocado novamente nesse mesmo buffer.

O número de bytes criptografados nesse buffer é especificado por pdwDataLen.

[in, out] pdwDataLen

Um ponteiro para um valor DWORD que indica o comprimento do buffer de pbData . Antes de chamar essa função, o aplicativo de chamada define o valor DWORD para o número de bytes a serem descriptografados. Após o retorno, o valor DWORD contém o número de bytes do texto sem formatação descriptografado.

Quando um de criptografia de bloco é usado, esse comprimento de dados deve ser um múltiplo do tamanho do bloco, a menos que esta seja a seção final dos dados a ser descriptografada e o parâmetro Final é VERDADEIRO.

Valor de retorno

Se a função for bem-sucedida, a função retornará diferente de zero (TRUE).

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

Os códigos de erro precedidos pelo NTE são gerados pelo CSP específico que está sendo usado. Alguns códigos de erro possíveis seguem.

Observações

Se uma grande quantidade de dados deve ser descriptografada, ela pode ser feita em seções chamando CryptDecrypt repetidamente. O parâmetro Final deve ser definido como VERDADEIRO somente na última chamada para CryptDecrypt, de modo que o mecanismo de descriptografia possa concluir corretamente o processo de descriptografia. As seguintes ações extras são executadas quando Final é verdadeiro:

• Se a chave for uma chave de criptografia de bloco, os dados serão adicionados a um múltiplo do tamanho do bloco da criptografia. Para localizar o tamanho do bloco de uma criptografia, use CryptGetKeyParam para obter o valor KP_BLOCKLEN da chave.
• Se a criptografia estiver operando em um modo de encadeamento , a próxima operação CryptDecrypt redefinirá o registro de comentários da criptografia para o valor KP_IV da chave.
• Se a codificação for umade criptografia de fluxo , a próxima chamada CryptDecrypt redefinirá a criptografia para seu estado de inicial.

Não há como definir o registro de comentários da criptografia para o valor KP_IV da chave sem definir o parâmetro Final como VERDADEIRO. Se isso for necessário, como no caso em que você não deseja adicionar um bloco de preenchimento adicional ou alterar o tamanho de cada bloco, você pode simular isso criando uma duplicata da chave original usando a função CryptDuplicateKey e passando a chave duplicada para a função CryptDecrypt. Isso faz com que o KP_IV da chave original seja colocado na chave duplicada. Depois de criar ou importar a chave original, você não poderá usar a chave original para criptografia porque o registro de comentários da chave será alterado. O pseudocódigo a seguir mostra como isso pode ser feito.

// Set the IV for the original key. Do not use the original key for 
// encryption or decryption after doing this because the key's 
// feedback register will get modified and you cannot change it.
CryptSetKeyParam(hOriginalKey, KP_IV, newIV)

while(block = NextBlock())
{
    // Create a duplicate of the original key. This causes the 
    // original key's IV to be copied into the duplicate key's 
    // feedback register.
    hDuplicateKey = CryptDuplicateKey(hOriginalKey)

    // Decrypt the block with the duplicate key.
    CryptDecrypt(hDuplicateKey, block)

    // Destroy the duplicate key. Its feedback register has been 
    // modified by the CryptEncrypt function, so it cannot be used
    // again. It will be re-duplicated in the next iteration of the 
    // loop.
    CryptDestroyKey(hDuplicateKey)
}

O provedor de criptografia Microsoft Enhanced Cryptographic dá suporte à criptografia direta com RSA de chaves públicas e descriptografia com chaves privadas RSA. A criptografia usa pkcs nº 1 de preenchimento. Na descriptografia, esse preenchimento é verificado. O comprimento de dados a serem descriptografados deve ter o mesmo comprimento que o módulo da chave RSA usada para descriptografar os dados. Se o texto criptografado tiver zeros nos bytes mais significativos, esses bytes deverão ser incluídos no buffer de dados de entrada e no comprimento do buffer de entrada. O texto criptografado deve estar em formato de little-endian.

Exemplos

Para obter um exemplo que usa essa função, consulte Exemplo de Programa C: Descriptografando um arquivo.

Requisitos

Consulte também

CryptCreateHash

CryptEncrypt

CryptGenKey

CryptGetHashParam

CryptGetKeyParam

CryptImport Key

CryptMsgOpenToEncode

CryptSignHash

CryptVerifySignature

funções de criptografia/descriptografia de dados