CryptCATAdminCalcHashFromFileHandle-Funktion (mscat.h)

  • Artikel

[Die CryptCATAdminCalcHashFromFileHandle-Funktion ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]

Die Funktion CryptCATAdminCalcHashFromFileHandle berechnet den Hash für eine Datei. Diese Funktion verfügt über keine zugeordnete Importbibliothek. Sie müssen die Funktionen LoadLibrary und GetProcAddress verwenden, um dynamisch mit Wintrust.dll zu verknüpfen.

Syntax

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

Parameter

[in] hFile

Ein Handle für die Datei, deren Hash berechnet wird. Dieser Parameter darf nicht NULL sein und muss ein gültiges Dateihandle sein.

[in, out] pcbHash

Ein Zeiger auf eine DWORD-Variable , die die Anzahl der Bytes in pbHash enthält. Legen Sie bei der Eingabe pcbHash auf die Anzahl der Bytes fest, die pbHash zugeordnet sind. Nach der Rückgabe enthält pcbHash die Anzahl der zurückgegebenen Bytes in pbHash. Wenn pbHash als NULL übergeben wird, enthält pcbHash die Anzahl der Bytes, die pbHash zugeordnet werden sollen.

[in] pbHash

Ein Zeiger auf einen BYTE-Puffer , der den Hash empfängt. Wenn dieser Parameter als NULL übergeben wird, enthält pcbHash die Anzahl der Bytes, die pbHash zugeordnet werden sollen, und ein anschließender Aufruf kann erfolgen, um den Hash abzurufen.

[in] dwFlags

Dieser Parameter ist für die zukünftige Verwendung reserviert und muss auf 0 (null) festgelegt werden.

Rückgabewert

Der Rückgabewert ist TRUE , wenn die Funktion erfolgreich ist. FALSE , wenn die Funktion fehlschlägt. Wenn FALSE zurückgegeben wird, rufen Sie die GetLastError-Funktion auf, um den Grund für den Fehler zu ermitteln. Wenn nicht genügend Arbeitsspeicher für pbHash zugewiesen wurde, legt die CryptCATAdminCalcHashFromFileHandle-Funktion den letzten Fehler auf ERROR_INSUFFICIENT_BUFFER fest.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile mscat.h
Bibliothek Wintrust.lib
DLL Wintrust.dll