Fungsi WTHelperGetFileHash

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

Fungsi WTHelperGetFileHash memverifikasi tanda tangan file yang ditandatangani dan mendapatkan nilai hash dan pengidentifikasi algoritma untuk file tersebut.

Catatan

Fungsi ini tidak dideklarasikan dalam file header yang diterbitkan. Untuk menggunakan fungsi ini, deklarasikan dalam format yang tepat yang ditunjukkan. Fungsi ini juga tidak memiliki pustaka impor terkait. Anda harus menggunakan fungsi LoadLibrary dan GetProcAddress untuk menautkan secara dinamis ke Wintrust.dll.

 

Sintaks

LONG WINAPI WTHelperGetFileHash(
  _In_        LPCWSTR pwszFilename,
  _In_        DWORD   dwFlags,
  _Inout_opt_ PVOID   pvReserved,
  _Out_opt_   BYTE    *pbFileHash,
  _Inout_opt_ DWORD   *pcbFileHash,
  _Out_opt_   ALG_ID  *pHashAlgid
);

Parameter

pwszFilename [in]

Penunjuk ke string Unicode yang dihentikan null yang berisi jalur dan nama file file untuk mendapatkan hash.

dwFlags [in]

Parameter ini tidak digunakan dan harus nol.

pvReserved [masuk, keluar, opsional]

Parameter ini tidak digunakan dan harus NULL.

pbFileHash [keluar, opsional]

Penunjuk ke buffer untuk menerima nilai hash untuk file. Parameter pcbFileHash berisi ukuran buffer ini.

pcbFileHash [masuk, keluar, opsional]

Penunjuk ke variabel DWORD yang, pada input, berisi ukuran, dalam byte, dari buffer pbFileHash dan, pada output, menerima ukuran, dalam byte, dari nilai hash.

Untuk mendapatkan ukuran nilai hash yang diperlukan, berikan NULL untuk parameter pbFileHash . Fungsi ini akan menempatkan ukuran yang diperlukan, dalam byte, dari nilai hash di lokasi ini.

Jika parameter pbFileHash tidak NULL, dan ukurannya tidak cukup besar untuk menerima nilai hash, fungsi ini akan menempatkan ukuran yang diperlukan, dalam byte, di lokasi ini dan mengembalikan ERROR_MORE_DATA.

pHashAlgid [keluar, opsional]

Penunjuk ke variabel ALG_ID untuk menerima pengidentifikasi algoritma yang digunakan untuk membuat nilai hash. Parameter ini bisa NULL jika informasi ini tidak diperlukan.

Menampilkan nilai

Mengembalikan kode status yang menunjukkan keberhasilan atau kegagalan fungsi.

Kemungkinan kode pengembalian termasuk, tetapi tidak terbatas pada, berikut ini.

Menampilkan kode	Deskripsi
ERROR_SUCCESS	File ditandatangani, dan tanda tangan diverifikasi.
ERROR_MORE_DATA	Parameter pbFileHash bukan NULL, dan ukuran yang ditentukan oleh parameter pcbFileHash tidak cukup besar untuk menerima hash.
ERROR_NOT_ENOUGH_MEMORY	Terjadi kegagalan alokasi memori.
TRUST_E_BAD_DIGEST	Tanda tangan file tidak diverifikasi.
TRUST_E_NOSIGNATURE	File tidak ditandatangani atau memiliki tanda tangan yang tidak valid.

 

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
DLL	Wintrust.dll