Fungsi MsiGetFileVersionW (msi.h)

Artikel
11/20/2024

MsiGetFileVersion mengembalikan string versi dan string bahasa dalam format yang diharapkan alat penginstal untuk menemukannya dalam database. Jika Anda hanya menginginkan informasi versi, atur lpLangBuf dan pcchLangBuf ke 0 (nol). Jika Anda hanya ingin informasi bahasa, atur lpVersionBuf dan pcchVersionBuf ke 0 (nol).

Sintaksis

UINT MsiGetFileVersionW(
  [in]      LPCWSTR szFilePath,
  [out]     LPWSTR  lpVersionBuf,
  [in, out] LPDWORD pcchVersionBuf,
  [out]     LPWSTR  lpLangBuf,
  [in, out] LPDWORD pcchLangBuf
);

Parameter

[in] szFilePath

Menentukan jalur ke file.

[out] lpVersionBuf

Mengembalikan versi file.

Atur ke 0 hanya untuk informasi bahasa.

[in, out] pcchVersionBuf

Jumlah buffer masuk dan keluar sebagai jumlah TCHAR.

Atur ke 0 (nol) hanya untuk informasi bahasa. Pada input, ini adalah ukuran penuh buffer, termasuk spasi untuk karakter null yang mengakhiri. Jika buffer yang diteruskan terlalu kecil, jumlah yang dikembalikan tidak menyertakan karakter null yang mengakhiri.

[out] lpLangBuf

Mengembalikan bahasa file.

Atur ke 0 (nol) untuk informasi versi saja.

[in, out] pcchLangBuf

Jumlah buffer masuk dan keluar sebagai jumlah TCHAR.

Atur ke 0 (nol) untuk informasi versi saja. Pada input, ini adalah ukuran penuh buffer, termasuk spasi untuk karakter null yang mengakhiri. Jika buffer yang diteruskan terlalu kecil, jumlah yang dikembalikan tidak menyertakan karakter null yang mengakhiri.

Mengembalikan nilai

Nilai	Arti
ERROR_SUCCESS	Penyelesaian berhasil.
ERROR_FILE_NOT_FOUND	File tidak ada.
ERROR_ACCESS_DENIED	File tidak dapat dibuka untuk mendapatkan informasi versi.
ERROR_FILE_INVALID	File tidak berisi informasi versi.
ERROR_INVALID_DATA	Informasi versi tidak valid.
E_FAIL	Kesalahan tak terduga.

Komentar

Nota

Header msi.h mendefinisikan MsiGetFileVersion 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

Fungsi Status Sistem

Bagikan melalui