Função CryptHashCertificate (wincrypt.h)

Artigo
08/27/2023

Importante Essa API foi preterida. O software novo e existente deve começar a usar APIs de Próxima Geração de Criptografia. A Microsoft pode remover essa API em versões futuras.

A função CryptHashCertificatefaz hashes de todo o conteúdo codificado de um certificado , incluindo sua assinatura.

Sintaxe

BOOL CryptHashCertificate(
  [in]      HCRYPTPROV_LEGACY hCryptProv,
  [in]      ALG_ID            Algid,
  [in]      DWORD             dwFlags,
  [in]      const BYTE        *pbEncoded,
  [in]      DWORD             cbEncoded,
  [out]     BYTE              *pbComputedHash,
  [in, out] DWORD             *pcbComputedHash
);

Parâmetros

[in] hCryptProv

Esse parâmetro não é usado e deve ser definido como NULL.

Windows Server 2003 e Windows XP: Um identificador do CSP ( provedor de serviços criptográficos ) a ser usado para calcular o hash.

O tipo de dados desse parâmetro é HCRYPTPROV.

A menos que haja um motivo forte para passar um CSP específico em hCryptProv, zero será passado. Passar zero faz com que o provedor padrão RSA ou DSS ( Digital Signature Standard ) seja adquirido antes de fazer operações de hash, verificação de assinatura ou criptografia de destinatário.

[in] Algid

Uma estrutura ALG_ID que especifica o algoritmo de hash a ser usado. Se Argel for zero, o algoritmo de hash padrão, SHA1, será usado.

[in] dwFlags

Valor a ser passado para a API de hash. Para obter detalhes, consulte CryptCreateHash.

[in] pbEncoded

Endereço do conteúdo codificado a ser hash.

[in] cbEncoded

O tamanho, em bytes, do conteúdo codificado.

[out] pbComputedHash

Um ponteiro para um buffer para receber o hash computado.

Para definir o tamanho dessas informações para fins de alocação de memória, esse parâmetro pode ser NULL. Para obter mais informações, consulte Recuperando dados de comprimento desconhecido.

[in, out] pcbComputedHash

Um ponteiro para um DWORD que contém o tamanho, em bytes, do buffer apontado pelo parâmetro pbComputedHash . Quando a função retorna, o DWORD contém o número de bytes armazenados no buffer.

Nota Ao processar os dados retornados no buffer, os aplicativos precisam usar o tamanho real dos dados retornados. O tamanho real pode ser ligeiramente menor do que o tamanho do buffer especificado na entrada. Na entrada, os tamanhos de buffer geralmente são especificados grandes o suficiente para garantir que os maiores dados de saída possíveis caibam no buffer. Na saída, a variável apontada por esse parâmetro é atualizada para refletir o tamanho real dos dados copiados para o buffer.

Valor retornado

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.

Nota Erros das funções chamadas CryptCreateHash, CryptGetHashParam e CryptHashData podem ser propagados para essa função.

Requisitos


Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wincrypt.h
Biblioteca	Crypt32.lib
DLL	Crypt32.dll

Confira também

CryptHashPublicKeyInfo

CryptHashToBeSigned

Funções Gerenciamento de Dados

Compartilhar via