Fungsi MsiUseFeatureExA (msi.h)

Artikel
11/20/2024

Fungsi MsiUseFeatureEx meningkatkan jumlah penggunaan untuk fitur tertentu dan menunjukkan status penginstalan untuk fitur tersebut. Fungsi ini harus digunakan untuk menunjukkan niat aplikasi untuk menggunakan fitur.

Sintaksis

INSTALLSTATE MsiUseFeatureExA(
  [in] LPCSTR szProduct,
  [in] LPCSTR szFeature,
  [in] DWORD  dwInstallMode,
  [in] DWORD  dwReserved
);

Parameter

[in] szProduct

Menentukan kode produk untuk produk yang memiliki fitur yang akan digunakan.

[in] szFeature

Mengidentifikasi fitur yang akan digunakan.

[in] dwInstallMode

Parameter ini dapat memiliki nilai berikut.

Nilai	Arti
INSTALLMODE_NODETECTION	Nilai pengembalian menunjukkan status penginstalan.

[in] dwReserved

Dicadangkan untuk digunakan di masa mendatang. Nilai ini harus diatur ke 0.

Mengembalikan nilai

Nilai	Arti
INSTALLSTATE_ABSENT	Fitur ini tidak diinstal.
INSTALLSTATE_ADVERTISED	Fitur ini diiklankan
INSTALLSTATE_LOCAL	Fitur ini diinstal secara lokal dan tersedia untuk digunakan.
INSTALLSTATE_SOURCE	Fitur ini diinstal dari sumber dan tersedia untuk digunakan.
INSTALLSTATE_UNKNOWN	Fitur ini tidak diterbitkan.

Komentar

Fungsi MsiUseFeatureEx hanya boleh digunakan pada fitur yang diketahui diterbitkan. INSTALLSTATE_UNKNOWN menunjukkan bahwa program mencoba menggunakan fitur yang tidak diterbitkan. Aplikasi harus menentukan apakah fitur diterbitkan sebelum memanggil MsiUseFeature dengan memanggil MsiQueryFeatureState atau MsiEnumFeatures. Aplikasi harus melakukan panggilan ini saat diinisialisasi. Aplikasi hanya boleh menggunakan fitur yang diketahui diterbitkan.

Nota

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

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

Application-Only Functions

Bagikan melalui