Fungsi MsiGetFileHashW (msi.h)

Artikel
11/20/2024

Fungsi MsiGetFileHash mengambil jalur ke file dan mengembalikan hash 128-bit dari file tersebut. Alat penulisan dapat menggunakan MsiGetFileHash untuk mendapatkan hash file yang diperlukan untuk mengisi tabel MsiFileHash.

Penginstal Windows menggunakan hashing file sebagai sarana untuk mendeteksi dan menghilangkan penyalinan file yang tidak perlu. Hash file yang disimpan dalam tabel MsiFileHash dapat dibandingkan dengan hash file yang ada di komputer pengguna.

Sintaksis

UINT MsiGetFileHashW(
  [in]  LPCWSTR          szFilePath,
  [in]  DWORD            dwOptions,
  [out] PMSIFILEHASHINFO pHash
);

Parameter

[in] szFilePath

Jalur ke file yang akan di-hash.

[in] dwOptions

Nilai dalam kolom ini harus 0. Parameter ini dicadangkan untuk digunakan di masa mendatang.

[out] pHash

Penunjuk ke informasi hash file yang dikembalikan.

Mengembalikan nilai

Nilai	Arti
ERROR_SUCCESS	Fungsi berhasil diselesaikan.
ERROR_FILE_NOT_FOUND	File tidak ada.
ERROR_ACCESS_DENIED	File tidak dapat dibuka untuk mendapatkan informasi versi.
E_FAIL	Terjadi kesalahan tak terduga.

Komentar

Seluruh hash file 128-bit dikembalikan sebagai empat bidang 32-bit. Penomoran empat bidang berbasis nol. Nilai yang dikembalikan oleh MsiGetFileHa sh sesuai dengan empat bidang struktur MSIFILEHASHINFO . Bidang pertama sesuai dengan kolom HashPart1 dari tabel MsiFileHash, bidang kedua sesuai dengan kolom HashPart2, bidang ketiga sesuai dengan kolom HashPart3, dan bidang keempat sesuai dengan kolom HashPart4.

Informasi hash yang dimasukkan ke dalam tabel MsiFileHash harus diperoleh dengan memanggil MsiGetFileHash atau metode FileHash. Jangan mencoba menggunakan metode lain untuk menghasilkan hash file.

Nota

Header msi.h mendefinisikan MsiGetFileHash sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows Installer 5.0 di Windows Server 2012, Windows 8, Windows Server 2008 R2 atau Windows 7. Windows Installer 4.0 atau Windows Installer 4.5 pada Windows Server 2008 atau Windows Vista. Windows Installer pada Windows Server 2003 atau Windows XP. Lihat Persyaratan Run-Time Penginstal Windows untuk informasi tentang paket layanan Windows minimum yang diperlukan oleh versi Penginstal Windows.
Platform Target	Windows
Header	msi.h
Pustaka	Msi.lib
DLL	Msi.dll

Lihat juga

Penerapan Versi File Default

MSIFILEHASHINFO

tabel MsiFileHash

Bagikan melalui