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

指向包含 pbHash 中字节数的 DWORD 变量的指针。 输入时，将 “pbHash ”设置为为 pbHash 分配的字节数。 返回时，以 pbHash 形式包含返回的字节数。 如果 pbHash 以 NULL 形式传递，则 pbHash 包含要为 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
Library	Wintrust.lib
DLL	Wintrust.dll