Fungsi MsiInstallProductW (msi.h)

Artikel
11/20/2024

Fungsi MsiInstallProduct menginstal atau menghapus instalasi produk.

Sintaksis

UINT MsiInstallProductW(
  [in] LPCWSTR szPackagePath,
  [in] LPCWSTR szCommandLine
);

Parameter

[in] szPackagePath

String null-terminated yang menentukan jalur ke lokasi paket Windows Installer. Nilai string dapat berisi URL (misalnya http://packageLocation/package/package.msi), jalur jaringan (misalnya \packageLocation\package.msi), jalur file (misalnya file://packageLocation/package.msi), atau jalur lokal (misalnya D:\packageLocation\package.msi).

[in] szCommandLine

String null-terminated yang menentukan pengaturan properti baris perintah. Ini harus menjadi daftar format Property=Setting Property=Setting. Untuk informasi selengkapnya, lihat Tentang Properti.

Untuk melakukan penginstalan administratif, sertakan ACTION=ADMIN di szCommandLine. Untuk informasi selengkapnya, lihat properti TINDAKAN .

Mengembalikan nilai

Nilai	Arti
ERROR_SUCCESS	Fungsi berhasil diselesaikan.
Kesalahan yang berkaitan dengan tindakan	Untuk informasi selengkapnya, lihat kode kesalahan .
Kesalahan Inisialisasi	Terjadi kesalahan yang berkaitan dengan inisialisasi.

Untuk informasi selengkapnya, lihat Pesan Kesalahan yang Ditampilkan.

Komentar

Fungsi MsiInstallProduct menampilkan antarmuka pengguna dengan pengaturan dan mode log saat ini.

Anda dapat mengubah pengaturan antarmuka pengguna dengan menggunakanMsiSetInternalUI , MsiSetExternalUI, atau fungsi MsiSetExternalUIRecord.
Anda dapat mengatur mode log dengan menggunakan fungsi MsiEnableLog.
Anda dapat menghapus produk sepenuhnya dengan mengatur REMOVE=ALL di szCommandLine.

Untuk informasi selengkapnya, lihat HAPUS Properti.

Nota

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

Pesan Kesalahan yang Ditampilkan

Kode Kesalahan

Kesalahan Inisialisasi

Penginstalan dan Konfigurasi

Penginstalan Multiple-Package

Bagikan melalui