Fungsi CryptCATAdminCalcHashFromFileHandle (mscat.h)

  • Artikel

[Fungsi CryptCATAdminCalcHashFromFileHandle tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Ini mungkin diubah atau tidak tersedia dalam versi berikutnya.]

Fungsi CryptCATAdminCalcHashFromFileHandle menghitung hash untuk file. Fungsi ini tidak memiliki pustaka impor terkait. Anda harus menggunakan fungsi LoadLibrary dan GetProcAddress untuk menautkan secara dinamis ke Wintrust.dll.

Sintaks

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

Parameter

[in] hFile

Handel ke file yang hash-nya sedang dihitung. Parameter ini tidak boleh NULL dan harus merupakan handel file yang valid.

[in, out] pcbHash

Penunjuk ke variabel DWORD yang berisi jumlah byte dalam pbHash. Setelah input, atur pcbHash ke jumlah byte yang dialokasikan untuk pbHash. Setelah kembali, pcbHash berisi jumlah byte yang dikembalikan dalam pbHash. Jika pbHash diteruskan sebagai NULL, maka pcbHash berisi jumlah byte yang akan dialokasikan untuk pbHash.

[in] pbHash

Penunjuk ke buffer BYTE yang menerima hash. Jika parameter ini diteruskan sebagai NULL, maka pcbHash berisi jumlah byte yang akan dialokasikan untuk pbHash, dan panggilan berikutnya dapat dilakukan untuk mengambil hash.

[in] dwFlags

Parameter ini dicadangkan untuk digunakan di masa mendatang dan harus diatur ke nol.

Nilai kembali

Nilai yang dikembalikan adalah TRUE jika fungsi berhasil; FALSE jika fungsi gagal. Jika FALSE dikembalikan, panggil fungsi GetLastError untuk menentukan alasan kegagalan. Jika memori tidak cukup telah dialokasikan untuk pbHash, fungsi CryptCATAdminCalcHashFromFileHandle akan mengatur kesalahan terakhir ke ERROR_INSUFFICIENT_BUFFER.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header mscat.h
Pustaka Wintrust.lib
DLL Wintrust.dll