CryptCATAdminCalcHashFromFileHandle 函式 (mscat.h)

[ CryptCATAdminCalcHashFromFileHandle 函式可用於需求一節中指定的操作系統。 後續版本可能會變更或無法使用。]

CryptCATAdminCalcHashFromFileHandle 函式會計算檔案的哈希。 此函式沒有相關聯的匯入連結庫。 您必須使用 LoadLibrary 和 GetProcAddress 函式，動態連結至 Wintrust.dll。

語法

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

參數

[in] hFile

正在計算其哈希的檔案句柄。 此參數不可為 NULL ，而且必須是有效的檔句柄。

[in, out] pcbHash

DWORD 變數的指標，其中包含 pbHash 中的位元元組數目。 在輸入時，將設定為配置給 pbHash 的位元元組數目。 傳回時，其會包含 pbHash 中傳回的位元組數目。 如果將 pbHash 傳遞為 NULL， 則其會 包含要配置給 pbHash 的位元元組數目。

[in] pbHash

接收哈希的 BYTE 緩衝區指標。 如果這個參數以 NULL 的形式傳入， 則其會 包含要配置給 pbHash 的位元組數目，而且可以進行後續呼叫來擷取哈希。

[in] dwFlags

此參數保留供日後使用，且必須設定為零。

傳回值

如果函式成功，則傳回值為 TRUE ; 如果 函式失敗，則為 FALSE。 如果傳回 FALSE ，請呼叫 GetLastError 函 式來判斷失敗的原因。 如果已配置足夠的記憶體給 pbHash，CryptCATAdminCalcHashFromFileHandle 函式會將最後一個錯誤設定為 ERROR_INSUFFICIENT_BUFFER。

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
目標平台	Windows
標頭	mscat.h
程式庫	Wintrust.lib
Dll	Wintrust.dll