Fungsi MsiCollectUserInfoA (msi.h)

  • Artikel

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

Sintaks

UINT MsiCollectUserInfoA(
  [in] LPCSTR szProduct
);

Parameter

[in] szProduct

Menentukan kode produk dari produk yang informasi penggunanya dikumpulkan.

Menampilkan nilai

Nilai Makna
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.
 
 

Keterangan

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 terdaftar. Karena API ini memerlukan antarmuka pengguna yang ditulis, tingkat antarmuka pengguna harus diatur ke penuh dengan memanggil MsiSetInternalUI sebagai INSTALLUILEVEL_FULL.

MsiCollectUserInfo memanggil Dialog FirstRun.

Catatan

Header msi.h mendefinisikan MsiCollectUserInfo 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. Pemasang Windows pada Windows Server 2003 atau Windows XP. Lihat Persyaratan Run-Time Penginstal Windows untuk informasi tentang paket layanan Windows minimum yang diperlukan oleh versi Pemasang Windows.
Target Platform Windows
Header msi.h
Pustaka Msi.lib
DLL Msi.dll

Lihat juga

Fungsi Khusus Aplikasi

Kode Kesalahan

Kesalahan Inisialisasi