Compartilhar via


Função CryptHashCertificate2 (wincrypt.h)

A função CryptHashCertificate2 faz hashes de um bloco de dados usando um provedor de hash CNG.

Sintaxe

BOOL CryptHashCertificate2(
  [in]      LPCWSTR    pwszCNGHashAlgid,
  [in]      DWORD      dwFlags,
            void       *pvReserved,
  [in]      const BYTE *pbEncoded,
  [in]      DWORD      cbEncoded,
  [out]     BYTE       *pbComputedHash,
  [in, out] DWORD      *pcbComputedHash
);

Parâmetros

[in] pwszCNGHashAlgid

O endereço de uma cadeia de caracteres Unicode terminada em nulo que contém o identificador de algoritmo de hash CNG do algoritmo de hash a ser usado para hash do certificado. Esse pode ser um dos Identificadores de Algoritmo CNG que representa um algoritmo de hash ou qualquer outro identificador de algoritmo de hash registrado.

[in] dwFlags

Um conjunto de sinalizadores que modificam o comportamento dessa função. Nenhum sinalizador é definido para essa função.

pvReserved

Reservado para uso futuro e deve ser NULL.

[in] pbEncoded

O endereço de uma matriz de bytes a ser hash. O parâmetro cbEncoded contém o tamanho dessa matriz.

[in] cbEncoded

O número de elementos na matriz pbEncoded .

[out] pbComputedHash

O endereço de um buffer que recebe o hash computado. A variável apontada pelo parâmetro pcbComputedHash contém o tamanho desse buffer.

[in, out] pcbComputedHash

O endereço de uma variável DWORD que, na entrada, contém o tamanho, em bytes, do buffer pbComputedHash . Depois que essa função retorna, essa variável contém o número de bytes copiados para o buffer pbComputedHash .

Retornar valor

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. Alguns dos códigos de erro possíveis são identificados nos tópicos a seguir.

BCryptOpenAlgorithmProvider
BCryptCreateHash
BCryptGetProperty
BCryptHashData
BCryptFinishHash

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho wincrypt.h
Biblioteca Crypt32.lib
DLL Crypt32.dll

Confira também

Funções Gerenciamento de Dados