Fungsi MsiSetComponentStateA (msiquery.h)

  • Artikel

Fungsi MsiSetComponentState mengatur komponen ke status yang diminta.

Sintaks

UINT MsiSetComponentStateA(
  [in] MSIHANDLE    hInstall,
  [in] LPCSTR       szComponent,
  [in] INSTALLSTATE iState
);

Parameter

[in] hInstall

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

[in] szComponent

Menentukan nama komponen.

[in] iState

Menentukan status yang akan ditetapkan. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai Makna
INSTALLSTATE_ABSENT
 Komponen dihapus instalannya.
INSTALLSTATE_LOCAL
 Komponen diinstal pada drive lokal.
INSTALLSTATE_SOURCE
 Komponen akan berjalan dari sumber, CD, atau jaringan.

Mengembalikan nilai

Fungsi MsiSetComponentState mengembalikan nilai berikut:

Keterangan

Fungsi MsiSetComponentState meminta perubahan status Tindakan rekaman dalam tabel Komponen.

Untuk informasi selengkapnya, lihat Memanggil Fungsi Database Dari Program.

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

Catatan

Header msiquery.h mendefinisikan MsiSetComponentState 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. Pemasang Windows 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