Fungsi MsiGetFileHashA (msi.h)

  • Artikel

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.

Pemasang 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.

Sintaks

UINT MsiGetFileHashA(
  [in]  LPCSTR           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

Arahkan ke informasi hash file yang dikembalikan.

Nilai kembali

Nilai Makna
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.
 
 

Keterangan

Seluruh hash file 128-bit dikembalikan sebagai empat bidang 32-bit. Penomoran empat bidang berbasis nol. Nilai yang dikembalikan oleh MsiGetFileHash 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.

Catatan

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

Persyaratan 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 di 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.
Target Platform Windows
Header msi.h
Pustaka Msi.lib
DLL Msi.dll

Lihat juga

Penerapan Versi File Default

MSIFILEHASHINFO

Tabel MsiFileHash