Fungsi MsiUseFeatureA (msi.h)

  • Artikel

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

Sintaks

INSTALLSTATE MsiUseFeatureA(
  [in] LPCSTR szProduct,
  [in] LPCSTR szFeature
);

Parameter

[in] szProduct

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

[in] szFeature

Mengidentifikasi fitur yang akan digunakan.

Nilai kembali

Nilai Makna
INSTALLSTATE_ABSENT
 Fitur ini tidak diinstal.
INSTALLSTATE_ADVERTISED
 Fitur ini diiklankan
INSTALLSTATE_BADCONFIG
 Data konfigurasi rusak.
INSTALLSTATE_INVALIDARG
 Argumen fungsi tidak valid.
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.
 
 

Keterangan

Fungsi MsiUseFeature 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 menginisialisasi. Aplikasi hanya boleh menggunakan fitur yang diketahui akan diterbitkan.

Catatan

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

Fungsi Khusus Aplikasi