Fungsi MsiGetComponentStateA (msiquery.h)

  • Artikel

Fungsi MsiGetComponentState mendapatkan status komponen.

Sintaks

UINT MsiGetComponentStateA(
  [in]  MSIHANDLE    hInstall,
  [in]  LPCSTR       szComponent,
  [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] szComponent

String yang dihentikan null yang menentukan nama komponen dalam produk.

[out] piInstalled

Menerima status terinstal saat ini. Parameter ini tidak boleh null. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai Makna
INSTALLSTATE_ABSENT
 Komponen tidak diinstal.
INSTALLSTATE_DEFAULT
 Komponen diinstal di lokasi default: lokal atau sumber.
INSTALLSTATE_LOCAL
 Komponen diinstal pada drive lokal.
INSTALLSTATE_REMOVED
 Komponen sedang dihapus. Dalam status tindakan dan tidak dapat diatur.
INSTALLSTATE_SOURCE
 Komponen berjalan dari sumber, CD-ROM, atau jaringan.
INSTALLSTATE_UNKNOWN
 Nama produk atau fitur yang tidak dikenal diteruskan ke fungsi.

[out] piAction

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

Mengembalikan nilai

Fungsi MsiGetComponentState mengembalikan nilai berikut:

Keterangan

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

Untuk informasi selengkapnya, lihat Memanggil Fungsi Database Dari Program.

Catatan

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