Função CryptCATAdminCalcHashFromFileHandle (mscat.h)

Artigo
03/08/2023

[A função CryptCATAdminCalcHashFromFileHandle está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes.]

A função CryptCATAdminCalcHashFromFileHandle calcula o hash de um arquivo. Essa função não tem biblioteca de importação associada. Você deve usar as funções LoadLibrary e GetProcAddress para vincular dinamicamente a Wintrust.dll.

Sintaxe

BOOL CryptCATAdminCalcHashFromFileHandle(
  [in]      HANDLE hFile,
  [in, out] DWORD  *pcbHash,
  [in]      BYTE   *pbHash,
  [in]      DWORD  dwFlags
);

Parâmetros

[in] hFile

Um identificador para o arquivo cujo hash está sendo calculado. Esse parâmetro não pode ser NULL e deve ser um identificador de arquivo válido.

[in, out] pcbHash

Um ponteiro para uma variável DWORD que contém o número de bytes em pbHash. Após a entrada, defina pcbHash como o número de bytes alocados para pbHash. Após o retorno, pcbHash contém o número de bytes retornados em pbHash. Se pbHash for passado como NULL, pcbHash conterá o número de bytes a serem alocados para pbHash.

[in] pbHash

Um ponteiro para um buffer BYTE que recebe o hash. Se esse parâmetro for passado como NULL, pcbHash conterá o número de bytes a serem alocados para pbHash e uma chamada subsequente poderá ser feita para recuperar o hash.

[in] dwFlags

Esse parâmetro é reservado para uso futuro e deve ser definido como zero.

Retornar valor

O valor retornado será TRUE se a função for bem-sucedida; FALSE se a função falhar. Se FALSE for retornado, chame a função GetLastError para determinar o motivo da falha. Se não houver memória suficiente alocada para pbHash, a função CryptCATAdminCalcHashFromFileHandle definirá o último erro como ERROR_INSUFFICIENT_BUFFER.

Requisitos

Requisito	Valor
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	mscat.h
Biblioteca	Wintrust.lib
DLL	Wintrust.dll

Compartilhar via