Fungsi MsiSourceListAddMediaDiskA (msi.h)
Fungsi MsiSourceListAddMediaDisk menambahkan atau memperbarui disk sumber media dari produk atau patch terdaftar. Jika disk yang ditentukan sudah ada, disk akan diperbarui dengan nilai baru. Jika disk yang ditentukan tidak ada, entri disk baru dibuat dengan nilai baru.
Sintaks
UINT MsiSourceListAddMediaDiskA(
[in] LPCSTR szProductCodeOrPatchCode,
[in, optional] LPCSTR szUserSid,
[in] MSIINSTALLCONTEXT dwContext,
[in] DWORD dwOptions,
[in] DWORD dwDiskId,
[in] LPCSTR szVolumeLabel,
[in, optional] LPCSTR szDiskPrompt
);
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 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.
[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] dwDiskId
Parameter ini menyediakan ID disk yang ditambahkan atau diperbarui.
[in] szVolumeLabel
szVolumeLabel menyediakan label disk yang ditambahkan atau diperbarui. Pembaruan menimpa label volume yang ada di registri. Untuk mengubah permintaan disk saja, dapatkan label volume yang ada dari registri dan berikan dalam panggilan ini bersama dengan perintah disk baru. Meneruskan NULL atau string kosong untuk szVolumeLabel mendaftarkan string kosong (panjang 0 byte) sebagai label volume.
[in, optional] szDiskPrompt
Pada entri ke MsiSourceListAddMediaDisk, szDiskPrompt menyediakan perintah disk yang ditambahkan atau diperbarui. Pembaruan menimpa perintah disk terdaftar.
Untuk mengubah label volume saja, dapatkan perintah disk yang ada yang terdaftar dan berikan saat memanggil MsiSourceListAddMediaDisk bersama dengan label volume baru. Melewati NULL atau string kosong mendaftarkan string kosong (panjang 0 byte) sebagai prompt disk.
Menampilkan nilai
Fungsi MsiSourceListAddMediaDisk mengembalikan nilai berikut.
| Nilai | Makna |
|---|---|
|
Pengguna tidak memiliki kemampuan untuk membaca sumber media yang ditentukan atau produk atau patch yang ditentukan. Ini tidak menunjukkan apakah sumber media, produk, atau patch ditemukan. |
|
Data konfigurasi rusak. |
|
Layanan Pemasang Windows tidak dapat diakses. |
|
Parameter yang tidak valid diteruskan ke fungsi. |
|
Nilai berhasil diurutkan ulang. |
|
Patch tidak ditemukan. |
|
Produk tidak ditemukan. |
|
Kegagalan internal yang tidak terduga. |
Keterangan
Administrator dapat memodifikasi penginstalan instans produk atau patch yang ada di bawah konteks komputer atau di bawah konteks per pengguna mereka sendiri (terkelola atau tidak dikelola.) Mereka dapat memodifikasi penginstalan produk atau instans patch yang ada di bawah konteks per pengguna yang dikelola pengguna. 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 produk atau instans patch yang ada di bawah konteks per pengguna pengguna lain (terkelola atau tidak dikelola.) 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, AllowLockDownMedia , dan AlwaysInstallElevated .
Catatan
Header msi.h mendefinisikan MsiSourceListAddMediaDisk 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 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 Pemasang 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