Fungsi MsiSourceListClearAllExA (msi.h)

Artikel
08/24/2023

Fungsi MsiSourceListClearAllEx menghapus semua sumber yang ada dari jenis sumber tertentu untuk produk atau instans patch yang ditentukan. Pendaftaran patch juga dihapus jika satu-satunya sumber patch dihapus dan jika patch tidak diinstal sebagai patch baru oleh klien mana pun dalam konteks yang sama. Menentukan bahwa MsiSourceListClearAllEx menghapus sumber saat ini untuk produk atau patch ini memaksa penginstal untuk mencari daftar sumber untuk sumber saat berikutnya sumber diperlukan.

Sintaks

UINT MsiSourceListClearAllExA(
  [in]           LPCSTR            szProductCodeOrPatchCode,
  [in, optional] LPCSTR            szUserSid,
  [in]           MSIINSTALLCONTEXT dwContext,
  [in]           DWORD             dwOptions
);

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 berupa 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. Menggunakan SID komputer ("S-1-5-18") mengembalikan PARAMETER ERROR_INVALID. Saat mereferensikan akun pengguna saat ini, szUserSID dapat berupa NULL dan dwContext dapat MSIINSTALLCONTEXT_USERMANAGED atau MSIINSTALLCONTEXT_USERUNMANAGED.

[in] dwContext

Parameter ini menentukan konteks produk atau instans patch. Parameter ini dapat berisi salah satu nilai berikut.

Jenis konteks	Makna
MSIINSTALLCONTEXT_USERMANAGED	Instans produk atau patch ada dalam konteks yang dikelola per pengguna.
MSIINSTALLCONTEXT_USERUNMANAGED	Instans produk atau patch ada dalam konteks per pengguna yang tidak dikelola.
MSIINSTALLCONTEXT_MACHINE	Instans produk atau patch ada dalam konteks per komputer.

[in] dwOptions

Nilai dwOptions menentukan interpretasi nilai szProductCodeOrPatchCode dan jenis sumber yang akan dihapus. Parameter ini harus merupakan kombinasi dari salah satu konstanta MSISOURCETYPE_* berikut dan salah satu konstanta MSICODE_* berikut.

Bendera	Makna
MSISOURCETYPE_MEDIA	Sumbernya adalah media.
MSISOURCETYPE_NETWORK	Sumbernya adalah jenis jaringan.
MSISOURCETYPE_URL	Sumbernya adalah jenis URL.
MSICODE_PATCH	szProductCodeOrPatchCode adalah kode patch.
MSICODE_PRODUCT	szProductCodeOrPatchCode adalah kode produk.

Nilai kembali

Nilai	Makna
ERROR_ACCESS_DENIED	Pengguna tidak memiliki kemampuan untuk menambahkan atau memindahkan sumber. Tidak menunjukkan apakah produk atau patch ditemukan.
ERROR_BAD_CONFIGURATION	Data konfigurasi rusak.
ERROR_INSTALL_SERVICE_FAILURE	Tidak dapat mengakses layanan Pemasang Windows.
ERROR_INVALID_PARAMETER	Parameter yang tidak valid diteruskan ke fungsi.
ERROR_SUCCESS	Semua sumber dari jenis yang ditentukan telah dihapus.
ERROR_UNKNOWN_PRODUCT	Produk yang ditentukan tidak diketahui.
ERROR_UNKNOWN_PATCH	Patch yang ditentukan tidak diketahui.
ERROR_FUNCTION_FAILED	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 MsiSourceListClearAllEx 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

Persyaratan	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 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

AllowLockdownBrowse

AlwaysInstallElevated

DisableBrowse

Tidak Didukung di Windows Installer 2.0 dan yang lebih lama

ProductCode

Bagikan melalui