Fungsi SetupSetSourceListW (setupapi.h)

Artikel
03/04/2024

[Fungsi ini tersedia untuk digunakan dalam sistem operasi yang ditunjukkan di bagian Persyaratan. Ini mungkin diubah atau tidak tersedia dalam versi berikutnya. SetupAPI tidak boleh lagi digunakan untuk menginstal aplikasi. Sebagai gantinya, gunakan Pemasang Windows untuk mengembangkan penginstal aplikasi. PenyetelanAPI terus digunakan untuk menginstal pengandar perangkat.]

Fungsi SetupSetSourceList memungkinkan pemanggil mengatur daftar sumber penginstalan untuk pengguna saat ini atau sistem (umum untuk semua pengguna).

Sintaks

WINSETUPAPI BOOL SetupSetSourceListW(
  [in] DWORD  Flags,
  [in] PCWSTR *SourceList,
  [in] UINT   SourceCount
);

Parameter

[in] Flags

Menentukan tipe daftar. Parameter ini bisa menjadi kombinasi dari nilai berikut.

SRCLIST_SYSTEM

Daftar ini adalah daftar per sistem Most Recently Used (MRU) yang disimpan di registri. Penelepon harus menjadi anggota grup lokal administrator.

SRCLIST_USER

Daftar ini adalah daftar MRU per pengguna yang disimpan dalam registri.

SRCLIST_TEMPORARY

Daftar yang ditentukan bersifat sementara dan akan menjadi satu-satunya daftar yang dapat diakses oleh proses saat ini hingga SetupCancelTemporarySourceList dipanggil atau SetSourceList dipanggil lagi.

Penting Jika daftar sementara diatur, sumber tidak ditambahkan ke atau dihapus dari sistem atau daftar pengguna, bahkan jika panggilan berikutnya ke SetupAddToSourceList atau SetupRemoveFromSourceList secara eksplisit menentukan daftar tersebut.

Catatan Salah satu bendera SRCLIST_SYSTEM, SRCLIST_USER, atau SRCLIST_TEMPORARY harus ditentukan.

SRCLIST_NOBROWSE

Pengguna tidak diizinkan untuk menambahkan atau mengubah sumber saat SetupPromptForDisk digunakan. Bendera ini biasanya digunakan dalam kombinasi dengan bendera SRCLIST_TEMPORARY.

[in] SourceList

Penunjuk ke array string untuk digunakan sebagai daftar sumber, seperti yang ditentukan oleh parameter Bendera .

[in] SourceCount

Jumlah elemen dalam array yang ditujukkan oleh SourceList.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah nilai bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Catatan

Header setupapi.h mendefinisikan SetupSetSourceList 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 XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	setupapi.h
Pustaka	Setupapi.lib
DLL	Setupapi.dll