Funzione CryptCATAdminCalcHashFromFileHandle (mscat.h)

Articolo
02/29/2024

[La funzione CryptCATAdminCalcHashFromFileHandle è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Potrebbe essere modificato o non disponibile nelle versioni successive.]

La funzione CryptCATAdminCalcHashFromFileHandle calcola l'hash per un file. Questa funzione non ha una libreria di importazione associata. È necessario usare le funzioni LoadLibrary e GetProcAddress per collegare dinamicamente a Wintrust.dll.

Sintassi

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

Parametri

[in] hFile

Handle per il file il cui hash viene calcolato. Questo parametro non può essere NULL e deve essere un handle di file valido.

[in, out] pcbHash

Puntatore a una variabile DWORD contenente il numero di byte in pbHash. Al momento dell'input, impostare pcbHash sul numero di byte allocati per pbHash. Al ritorno, pcbHash contiene il numero di byte restituiti in pbHash. Se pbHash viene passato come NULL, pcbHash contiene il numero di byte da allocare per pbHash.

[in] pbHash

Puntatore a un buffer BYTE che riceve l'hash. Se questo parametro viene passato come NULL, pcbHash contiene il numero di byte da allocare per pbHash e una chiamata successiva può essere effettuata per recuperare l'hash.

[in] dwFlags

Questo parametro è riservato per uso futuro e deve essere impostato su zero.

Valore restituito

Il valore restituito è TRUE se la funzione ha esito positivo; FALSE se la funzione ha esito negativo. Se viene restituito FALSE, chiamare la funzione GetLastError per determinare il motivo dell'errore. Se non è stata allocata memoria sufficiente per pbHash, la funzione CryptCATAdminCalcHashFromFileHandle imposterà l'ultimo errore su ERROR_INSUFFICIENT_BUFFER.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	mscat.h
Libreria	Wintrust.lib
DLL	Wintrust.dll