Fungsi MsiSourceListClearAllW (msi.h)
Fungsi
UINT MsiSourceListClearAllW(
[in] LPCWSTR szProduct,
[in] LPCWSTR szUserName,
[in] DWORD dwReserved
);
[in] szProduct
ProductCode produk yang akan dimodifikasi.
[in] szUserName
Nama pengguna untuk penginstalan per pengguna. Nama pengguna harus selalu dalam format DOMAIN\USERNAME (atau MACHINENAME\USERNAME untuk pengguna lokal).
String kosong atau null untuk penginstalan per mesin.
[in] dwReserved
Dicadangkan untuk digunakan di masa mendatang. Nilai ini harus diatur ke 0.
Fungsi
| Nilai | Arti |
|---|---|
|
Pengguna tidak memiliki kemampuan untuk menghapus daftar sumber untuk produk ini. |
|
Data konfigurasi rusak. |
|
Tidak dapat mengatasi nama pengguna. |
|
Fungsi tidak berhasil. |
|
Tidak dapat mengakses layanan penginstal. |
|
Parameter yang tidak valid diteruskan ke fungsi. |
|
Fungsi berhasil. |
|
Produk yang ditentukan tidak diketahui. |
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 mesin dan penginstalan per pengguna (terkelola atau tidak terkelola). Pengguna dapat diaktifkan untuk menelusuri sumber dengan mengatur kebijakan. Untuk informasi selengkapnya, lihat DisableBrowse, AllowLockdownBrowse, dan kebijakan AlwaysInstallElevated.
Jika sumber jaringan adalah sumber saat ini untuk produk, fungsi ini memaksa alat penginstal untuk mencari daftar sumber untuk sumber yang valid saat sumber diperlukan di lain waktu. Jika sumber saat ini adalah media atau sumber URL, sumber tersebut masih valid setelah panggilan ini dan daftar sumber tidak dicari kecuali MsiSourceListForceResolution juga dipanggil.
Jika nama pengguna adalah string kosong atau NULL, fungsi beroperasi pada penginstalan per mesin produk. Dalam hal ini, jika produk diinstal sebagai per pengguna saja, 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 instalasi produk yang tidak dikelola yang dapat ditemukan, fungsi kemudian mencoba memodifikasi penginstalan produk per pengguna terkelola. Jika tidak ada penginstalan produk per pengguna terkelola atau tidak terkelola yang dapat ditemukan, fungsi mengembalikan ERROR_UNKNOWN_PRODUCT, bahkan jika produk diinstal per mesin.
Fungsi ini tidak dapat mengubah penginstalan yang tidak dikelola untuk setiap pengguna selain pengguna saat ini. Jika nama pengguna bukan string kosong atau NULL, tetapi bukan pengguna saat ini, fungsi hanya memeriksa instalasi produk per pengguna terkelola untuk pengguna yang ditentukan. Jika produk tidak diinstal sebagai terkelola per pengguna untuk pengguna yang ditentukan, fungsi mengembalikan ERROR_UNKNOWN_PRODUCT, bahkan jika produk diinstal per mesin.
Catatan
Header msi.h mendefinisikan MsiSourceListClearAll sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praproscesor 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.
| 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 |
Konteks Penginstalan
LookupAccountName
ProductCode
Ketahanan Sumber