Fungsi MsiSourceListGetInfoA (msi.h)
Fungsi MsiSourceListGetInfo mengambil informasi tentang daftar sumber untuk produk atau patch dalam konteks tertentu.
Sintaks
UINT MsiSourceListGetInfoA(
[in] LPCSTR szProductCodeOrPatchCode,
[in, optional] LPCSTR szUserSid,
[in] MSIINSTALLCONTEXT dwContext,
[in] DWORD dwOptions,
[in] LPCSTR szProperty,
[out, optional] LPSTR szValue,
[in, out, optional] LPDWORD pcchValue
);
Parameter
[in] szProductCodeOrPatchCode
ProductCode atau patch GUID produk atau patch. Gunakan string yang dihentikan null. Jika string lebih panjang dari 39 karakter, fungsi gagal dan mengembalikan ERROR_INVALID_PARAMETER. Parameter ini tidak boleh NULL.
[in, optional] szUserSid
Parameter ini dapat menjadi pengidentifikasi keamanan string (SID) yang menentukan akun pengguna yang berisi produk atau patch. SID tidak divalidasi atau diselesaikan. SID yang salah dapat mengembalikan ERROR_UNKNOWN_PRODUCT atau ERROR_UNKNOWN_PATCH. Saat mereferensikan konteks komputer, szUserSID harus NULL dan dwContext harus MSIINSTALLCONTEXT_MACHINE.
[in] dwContext
Parameter ini menentukan konteks produk atau instans patch. Parameter ini dapat berisi salah satu nilai berikut.
[in] dwOptions
Nilai dwOptions menentukan arti szProductCodeOrPatchCode.
| Bendera | Makna |
|---|---|
|
szProductCodeOrPatchCode adalah GUID kode produk. |
|
szProductCodeOrPatchCode adalah GUID kode patch. |
[in] szProperty
String yang dihentikan null yang menentukan nilai properti yang akan diambil. Parameter szProperty dapat menjadi salah satu nilai berikut.
[out, optional] szValue
Buffer output yang menerima informasi. Buffer ini harus cukup besar untuk memuat informasi. Jika buffer terlalu kecil, fungsi mengembalikan ERROR_MORE_DATA dan mengatur *pcchValue ke jumlah TCHAR dalam nilai, tidak termasuk karakter NULL yang mengakhiri.
Jika szValue diatur ke NULL dan pcchValue diatur ke penunjuk yang valid, fungsi mengembalikan ERROR_SUCCESS dan mengatur *pcchValue ke jumlah TCHAR dalam nilai, tidak termasuk karakter NULL yang mengakhiri. Fungsi kemudian dapat dipanggil lagi untuk mengambil nilai, dengan buffer szValue cukup besar untuk berisi *pcchValue + 1 karakter.
Jika szValue dan pcchValue diatur ke NULL, fungsi mengembalikan ERROR_SUCCESS jika nilai ada, tanpa mengambil nilai.
[in, out, optional] pcchValue
Penunjuk ke variabel yang menentukan jumlah TCHAR dalam buffer szValue . Ketika fungsi kembali, parameter ini diatur ke ukuran nilai yang diminta apakah fungsi menyalin nilai ke dalam buffer yang ditentukan atau tidak. Ukuran dikembalikan sebagai jumlah TCHAR dalam nilai yang diminta, tidak termasuk karakter null yang mengakhiri.
Parameter ini dapat diatur ke NULL hanya jika szValue juga NULL, jika tidak, fungsi mengembalikan ERROR_INVALID_PARAMETER.
Mengembalikan nilai
Fungsi MsiSourceListGetInfo mengembalikan nilai berikut.
| Nilai | Makna |
|---|---|
|
Pengguna tidak memiliki kemampuan untuk membaca daftar sumber yang ditentukan. Ini tidak menunjukkan apakah produk atau patch ditemukan. |
|
Data konfigurasi rusak. |
|
Parameter yang tidak valid diteruskan ke fungsi. |
|
Buffer yang disediakan tidak cukup untuk memuat data yang diminta. |
|
Properti berhasil diambil. |
|
Patch tidak ditemukan. |
|
Produk tidak ditemukan. |
|
Properti sumber tidak ditemukan. |
|
Kegagalan internal yang tidak terduga. |
Keterangan
Administrator dapat memodifikasi penginstalan produk atau instans patch yang ada di bawah konteks komputer atau di bawah konteks per pengguna mereka sendiri (terkelola atau tidak terkelola.) Mereka dapat memodifikasi penginstalan produk atau instans patch yang ada di bawah konteks per pengguna yang dikelola pengguna mana pun. Administrator tidak dapat mengubah penginstalan produk atau instans patch pengguna lain yang ada di bawah konteks per pengguna lain yang tidak dikelola.
Non-administrator tidak dapat mengubah penginstalan instans produk atau patch yang ada di bawah konteks per pengguna pengguna lain (terkelola atau tidak terkelola.) Mereka dapat memodifikasi penginstalan produk atau instans patch yang ada di bawah konteks per pengguna mereka sendiri yang tidak dikelola. Mereka dapat memodifikasi penginstalan produk atau instans patch di bawah konteks mesin atau konteks yang dikelola per pengguna mereka sendiri hanya jika mereka diaktifkan untuk menelusuri produk atau sumber patch. Pengguna dapat diaktifkan untuk menelusuri sumber dengan mengatur kebijakan. Untuk informasi selengkapnya, lihat Kebijakan DisableBrowse, AllowLockdownBrowse, dan AlwaysInstallElevated .
Catatan
Header msi.h mendefinisikan MsiSourceListGetInfo 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
| 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 3.0 atau yang lebih baru 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. |
| Target Platform | Windows |
| Header | msi.h |
| Pustaka | Msi.lib |
| DLL | Msi.dll |
Lihat juga
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk