Fungsi MsiCollectUserInfoA (msi.h)

Artikel
11/20/2024

Fungsi MsiCollectUserInfo mendapatkan dan menyimpan informasi pengguna dan ID produk dari wizard penginstalan.

Sintaksis

UINT MsiCollectUserInfoA(
  [in] LPCSTR szProduct
);

Parameter

[in] szProduct

Menentukan kode produk produk tempat informasi pengguna dikumpulkan.

Mengembalikan nilai

Nilai	Arti
ERROR_INVALID_PARAMETER	Parameter yang tidak valid diteruskan ke fungsi.
ERROR_SUCCESS	Fungsi berhasil.
Kesalahan yang berkaitan dengan tindakan	Lihat kode kesalahan .
Kesalahan Inisialisasi	Terjadi kesalahan terkait inisialisasi.

Komentar

Fungsi MsiCollectUserInfo biasanya dipanggil oleh aplikasi selama eksekusi pertama aplikasi. Aplikasi pertama kali memanggil MsiGetUserInfo. Jika panggilan itu gagal, aplikasi memanggil MsiCollectUserInfo. MsiCollectUserInfo membuka paket penginstalan produk dan memanggil urutan wizard yang mengumpulkan informasi pengguna. Setelah menyelesaikan urutan, informasi pengguna didaftarkan. Karena API ini memerlukan antarmuka pengguna yang ditulis, tingkat antarmuka pengguna harus diatur ke penuh dengan memanggil MsiSetInternalUI sebagai INSTALLUILEVEL_FULL.

MsiCollectUserInfo memanggilDialog FirstRun .

Nota

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

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. 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.
Platform Target	Windows
Header	msi.h
Pustaka	Msi.lib
DLL	Msi.dll

Lihat juga

Application-Only Functions

Kode Kesalahan

Kesalahan Inisialisasi

Bagikan melalui