Fungsi MsiDoActionA (msiquery.h)

  • Artikel

Fungsi MsiDoAction menjalankan tindakan bawaan, tindakan kustom, atau tindakan wizard antarmuka pengguna.

Sintaks

UINT MsiDoActionA(
  [in] MSIHANDLE hInstall,
  [in] LPCSTR    szAction
);

Parameter

[in] hInstall

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

[in] szAction

Menentukan tindakan yang akan dijalankan.

Menampilkan nilai

Fungsi ini mengembalikan UINT.

Keterangan

Fungsi MsiDoAction menjalankan tindakan yang sesuai dengan nama yang disediakan. Jika nama tidak dikenali oleh alat penginstal sebagai tindakan bawaan atau sebagai tindakan kustom dalam tabel CustomAction, nama diteruskan ke objek handler antarmuka pengguna, yang dapat memanggil fungsi atau kotak dialog. Jika nama tindakan null disediakan, alat penginstal menggunakan nilai huruf besar properti ACTION sebagai tindakan yang akan dilakukan. Jika tidak ada nilai properti yang didefinisikan, tindakan default dilakukan, didefinisikan sebagai "INSTALL".

Tindakan yang memperbarui sistem, seperti tindakan InstallFiles dan WriteRegistryValues , tidak dapat dijalankan dengan memanggil MsiDoAction. Pengecualian untuk aturan ini adalah jika MsiDoAction dipanggil dari tindakan kustom yang dijadwalkan dalam tabel InstallExecuteSequence antara tindakan InstallInitialize dan InstallFinalize. Tindakan yang tidak memperbarui sistem, seperti AppSearch atau CostInitialize, dapat dipanggil.

Catatan

Header msiquery.h mendefinisikan MsiDoAction 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

   
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 Tindakan Alat Penginstal