Функция CryptCATAdminCalcHashFromFileHandle (mscat.h)

  • Статья

[Функция CryptCATAdminCalcHashFromFileHandle доступна для использования в операционных системах, указанных в разделе Требования. Он может быть изменен или недоступен в последующих версиях.]

Функция CryptCATAdminCalcHashFromFileHandle вычисляет хэш файла. У этой функции нет связанной библиотеки импорта. Для динамического связывания с Wintrust.dll необходимо использовать функции LoadLibrary и GetProcAddress .

Синтаксис

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

Параметры

[in] hFile

Дескриптор для файла, хэш которого вычисляется. Этот параметр не может иметь значение NULL и должен быть допустимым дескриптором файла.

[in, out] pcbHash

Указатель на переменную DWORD , содержащую количество байтов в pbHash. После ввода задайте для pcbHash число байтов, выделенных для pbHash. После возврата pcbHash содержит количество возвращаемых байтов в pbHash. Если pbHash передается как NULL, pcbHash содержит количество байтов, выделяемых для pbHash.

[in] pbHash

Указатель на буфер BYTE , который получает хэш. Если этот параметр передается как NULL, то pcbHash содержит количество байтов, выделяемых для pbHash, и последующий вызов может быть выполнен для получения хэша.

[in] dwFlags

Этот параметр зарезервирован для использования в будущем и должен иметь нулевое значение.

Возвращаемое значение

Возвращаемое значение равно TRUE , если функция выполнена успешно; False , если функция завершается сбоем. Если возвращается значение FALSE , вызовите функцию GetLastError , чтобы определить причину сбоя. Если для pbHash выделено недостаточно памяти, функция CryptCATAdminCalcHashFromFileHandle установит для последней ошибки значение ERROR_INSUFFICIENT_BUFFER.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header mscat.h
Библиотека Wintrust.lib
DLL Wintrust.dll