Fungsi MsiGetFeatureStateA (msiquery.h)

  • Artikel

Fungsi MsiGetFeatureState mendapatkan status fitur yang diminta.

Sintaks

UINT MsiGetFeatureStateA(
  [in]  MSIHANDLE    hInstall,
  [in]  LPCSTR       szFeature,
  [out] INSTALLSTATE *piInstalled,
  [out] INSTALLSTATE *piAction
);

Parameter

[in] hInstall

Tangani penginstalan yang disediakan untuk tindakan kustom DLL atau diperoleh melalui MsiOpenPackage, MsiOpenPackageEx, atau MsiOpenProduct.

[in] szFeature

Menentukan nama fitur dalam produk.

[out] piInstalled

Menentukan status terinstal saat ini yang dikembalikan. Parameter ini tidak boleh null. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai Makna
INSTALLSTATE_BADCONFIG
 Data konfigurasi rusak.
INSTALLSTATE_INCOMPLETE
 Penginstalan ditangguhkan atau sedang berlangsung.
INSTALLSTATE_SOURCEABSENT
 Fitur harus berjalan dari sumber, dan sumber tidak tersedia.
INSTALLSTATE_MOREDATA
 Buffer pengembalian penuh.
INSTALLSTATE_INVALIDARG
 Parameter yang tidak valid diteruskan ke fungsi.
INSTALLSTATE_UNKNOWN
 Produk atau fitur yang tidak dikenal ditentukan.
INSTALLSTATE_BROKEN
 Fitur ini rusak.
INSTALLSTATE_ADVERTISED
 Fitur yang diiklankan.
INSTALLSTATE_ABSENT
 Fitur ini dihapus instalannya.
INSTALLSTATE_LOCAL
 Fitur ini diinstal pada drive lokal.
INSTALLSTATE_SOURCE
 Fitur harus berjalan dari sumber, CD-ROM, atau jaringan.
INSTALLSTATE_DEFAULT
 Fitur ini diinstal di lokasi default: lokal atau sumber.

[out] piAction

Menerima tindakan yang diambil selama sesi penginstalan. Parameter ini tidak boleh null. Untuk nilai yang dikembalikan, lihat piInstalled.

Menampilkan nilai

Fungsi MsiGetFeatureState mengembalikan nilai berikut:

Keterangan

Lihat Memanggil Fungsi Database Dari Program.

Jika fungsi gagal, Anda dapat memperoleh informasi kesalahan yang diperluas dengan menggunakan MsiGetLastErrorRecord.

Catatan

Header msiquery.h mendefinisikan MsiGetFeatureState sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosektor 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

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

Lihat juga

Fungsi Pemilihan Alat Penginstal

Meneruskan Null sebagai Argumen Fungsi Pemasang Windows