Fungsi MsiSourceListAddSourceA (msi.h)

Artikel
08/24/2023

Fungsi MsiSourceListAddSource menambahkan ke daftar sumber jaringan valid yang berisi jenis sumber yang ditentukan untuk produk atau patch dalam konteks pengguna tertentu.

Jumlah sumber dalam properti SOURCELIST tidak terbatas.

Sintaks

UINT MsiSourceListAddSourceA(
  [in] LPCSTR szProduct,
  [in] LPCSTR szUserName,
  [in] DWORD  dwReserved,
  [in] LPCSTR szSource
);

Parameter

[in] szProduct

ProductCode produk yang akan dimodifikasi.

[in] szUserName

Nama pengguna untuk penginstalan per pengguna. Pada Windows 2000 atau Windows XP, nama pengguna harus selalu dalam format DOMAIN\USERNAME (atau MACHINENAME\USERNAME untuk pengguna lokal).

String kosong atau NULL untuk penginstalan per komputer.

[in] dwReserved

Disiapkan untuk penggunaan masa mendatang. Nilai ini harus diatur ke 0.

[in] szSource

Penunjuk ke string yang menentukan sumber.

Nilai kembali

Menampilkan kode	Deskripsi
ERROR_ACCESS_DENIED	Pengguna tidak memiliki kemampuan untuk menambahkan sumber.
ERROR_BAD_CONFIGURATION	Data konfigurasi rusak.
ERROR_BAD_USERNAME	Tidak dapat mengatasi nama pengguna.
ERROR_FUNCTION_FAILED	Fungsi tidak berhasil.
ERROR_INSTALL_SERVICE_FAILURE	Tidak dapat mengakses layanan alat penginstal.
ERROR_INVALID_PARAMETER	Parameter yang tidak valid diteruskan ke fungsi.
ERROR_SUCCESS	Sumber ditambahkan.
ERROR_UNKNOWN_PRODUCT	Produk yang ditentukan tidak diketahui.

Keterangan

Administrator dapat memodifikasi penginstalan per komputer, penginstalan non-terkelola per pengguna mereka sendiri, dan penginstalan terkelola per pengguna untuk pengguna mana pun. Non-administrator hanya dapat memodifikasi penginstalan per komputer dan penginstalan per pengguna (terkelola atau tidak terkelola) mereka sendiri. Pengguna dapat diaktifkan untuk menelusuri sumber dengan mengatur kebijakan. Untuk informasi selengkapnya, lihat kebijakan DisableBrowse, AllowLockdownBrowse, dan AlwaysInstallElevated .

Perhatikan bahwa fungsi ini hanya menambahkan sumber baru ke daftar sumber yang valid. Jika sumber lain digunakan untuk menginstal produk, sumber baru tidak digunakan sampai sumber saat ini tidak tersedia.

Pemanggil bertanggung jawab untuk memastikan bahwa sumber yang disediakan adalah gambar sumber yang valid untuk produk.

Jika nama pengguna adalah string kosong atau NULL, fungsi beroperasi pada penginstalan per komputer produk. Dalam hal ini, jika produk hanya diinstal dalam status per pengguna, fungsi mengembalikan ERROR_UNKNOWN_PRODUCT.

Jika nama pengguna bukan string kosong atau NULL, nama pengguna yang penginstalan produknya dimodifikasi. Jika nama pengguna adalah nama pengguna saat ini, fungsi pertama-tama mencoba memodifikasi penginstalan produk yang tidak dikelola. Jika tidak ada penginstalan produk yang tidak dikelola yang dapat ditemukan, fungsi kemudian mencoba memodifikasi penginstalan produk per pengguna terkelola. Jika tidak ada penginstalan produk yang dikelola atau tidak dikelola per pengguna yang dapat ditemukan, fungsi mengembalikan ERROR_UNKNOWN_PRODUCT, bahkan jika produk diinstal per komputer.

Fungsi ini tidak dapat mengubah penginstalan yang tidak dikelola untuk pengguna mana pun selain pengguna saat ini. Jika nama pengguna bukan string kosong atau NULL, tetapi bukan pengguna saat ini, fungsi hanya memeriksa penginstalan produk per pengguna terkelola untuk pengguna yang ditentukan. Jika produk tidak diinstal sebagai dikelola per pengguna untuk pengguna yang ditentukan, fungsi mengembalikan ERROR_UNKNOWN_PRODUCT, bahkan jika produk diinstal per mesin.

Catatan

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