Fungsi MsiGetUserInfoA (msi.h)

Artikel
11/20/2024

Fungsi MsiGetUserInfo mengembalikan informasi pengguna terdaftar untuk produk yang diinstal.

Sintaksis

USERINFOSTATE MsiGetUserInfoA(
  [in]      LPCSTR  szProduct,
  [out]     LPSTR   lpUserNameBuf,
  [in, out] LPDWORD pcchUserNameBuf,
  [out]     LPSTR   lpOrgNameBuf,
  [in, out] LPDWORD pcchOrgNameBuf,
  [in]      LPSTR   lpSerialBuf,
  [in, out] LPDWORD pcchSerialBuf
);

Parameter

[in] szProduct

Menentukan kode produk untuk produk yang akan dikueri.

[out] lpUserNameBuf

Penunjuk ke variabel yang menerima nama pengguna.

[in, out] pcchUserNameBuf

Penunjuk ke variabel yang menentukan ukuran, dalam karakter, dari buffer yang ditujukkan oleh parameter lpUserNameBuf. Ukuran ini harus mencakup karakter null yang mengakhiri.

[out] lpOrgNameBuf

Penunjuk ke buffer yang menerima nama organisasi.

[in, out] pcchOrgNameBuf

Penunjuk ke variabel yang menentukan ukuran, dalam karakter, dari buffer yang ditujukkan oleh parameter lpOrgNameBuf . Pada input, ini adalah ukuran penuh buffer, termasuk spasi untuk karakter null yang mengakhiri. Jika buffer yang diteruskan terlalu kecil, jumlah yang dikembalikan tidak menyertakan karakter null yang mengakhiri.

[in] lpSerialBuf

Penunjuk ke buffer yang menerima ID produk.

[in, out] pcchSerialBuf

Penunjuk ke variabel yang menentukan ukuran, dalam karakter, dari buffer yang ditujukkan oleh parameter lpSerialBuf. Pada input, ini adalah ukuran penuh buffer, termasuk spasi untuk karakter null yang mengakhiri. Jika buffer yang diteruskan terlalu kecil, jumlah yang dikembalikan tidak menyertakan karakter null yang mengakhiri.

Mengembalikan nilai

Nilai	Arti
USERINFOSTATE_ABSENT	Beberapa atau semua informasi pengguna tidak ada.
USERINFOSTATE_INVALIDARG	Salah satu parameter fungsi tidak valid.
USERINFOSTATE_MOREDATA	Buffer terlalu kecil untuk menyimpan data yang diminta.
USERINFOSTATE_PRESENT	Fungsi berhasil diselesaikan.
USERINFOSTATE_UNKNOWN	Kode produk tidak mengidentifikasi produk yang diketahui.

Komentar

Saat fungsi MsiGetUserInfo kembali, parameter pcchNameBuf berisi panjang string kelas yang disimpan dalam buffer. Jumlah yang dikembalikan tidak menyertakan karakter null yang dihentikan. Jika buffer tidak cukup besar, fungsi MsiGetUserInfo mengembalikan USERINFOSTATE_MOREDATA, dan MsiGetUserInfo berisi ukuran string, dalam karakter, tanpa menghitung karakter null.

Informasi pengguna dianggap ada bahkan tanpa adanya nama perusahaan.

Nota

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

Fungsi Status Sistem

Bagikan melalui