Fungsi SetupSetSourceListA (setupapi.h)

[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 Penginstal Windows untuk mengembangkan penginstal aplikasi. PenyetelanAPI terus digunakan untuk menginstal pengandar perangkat.]

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

Sintaksis

WINSETUPAPI BOOL SetupSetSourceListA(
  [in] DWORD Flags,
  [in] PCSTR *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 Paling Baru Digunakan (MRU) yang disimpan dalam registri. Pemanggil 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 daftar sistem atau 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 ketika 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 diacak oleh SourceList.

Mengembalikan nilai

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

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

Komentar

Nota

Header setupapi.h mendefinisikan SetupSetSourceList sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosektor 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

Syarat	Nilai
klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Platform Target	Windows
Header	setupapi.h
Pustaka	Setupapi.lib
DLL	Setupapi.dll

Lihat juga

Functions

Gambaran Umum

SetupAddToSourceList

SetupCancelTemporarySourceList

SetupRemoveFromSourceList