Fungsi SetupDiCreateDeviceInfoListExW (setupapi.h)
Fungsi SetupDiCreateDeviceInfoList membuat informasi perangkat kosong yang diatur pada komputer jarak jauh atau lokal dan secara opsional mengaitkan set dengan kelas penyiapan perangkat .
Sintaks
WINSETUPAPI HDEVINFO SetupDiCreateDeviceInfoListExW(
[in, optional] const GUID *ClassGuid,
[in, optional] HWND hwndParent,
[in, optional] PCWSTR MachineName,
PVOID Reserved
);
Parameter
[in, optional] ClassGuid
Penunjuk ke GUID kelas penyiapan perangkat untuk dikaitkan dengan kumpulan informasi perangkat yang baru dibuat. Jika parameter ini ditentukan, hanya perangkat kelas ini yang dapat disertakan dalam kumpulan informasi perangkat ini. Jika parameter ini diatur ke NULL, kumpulan informasi perangkat tidak terkait dengan kelas penyiapan perangkat tertentu.
[in, optional] hwndParent
Handel ke jendela tingkat atas yang akan digunakan untuk antarmuka pengguna apa pun yang terkait dengan tindakan khusus non-perangkat (seperti kotak dialog perangkat tertentu yang menggunakan daftar driver kelas global). Handel ini bersifat opsional dan dapat berupa NULL. Jika jendela tingkat atas tertentu tidak diperlukan, atur hwndParent ke NULL.
[in, optional] MachineName
Penunjuk ke string yang dihentikan NULL yang berisi nama komputer pada jaringan. Jika nama ditentukan, hanya perangkat pada komputer tersebut yang dapat dibuat dan dibuka dalam set informasi perangkat ini. Jika parameter ini diatur ke NULL, informasi perangkat yang ditetapkan adalah untuk perangkat di komputer lokal.
Perhatian
Menggunakan fungsi ini untuk mengakses komputer jarak jauh tidak didukung dimulai dengan Windows 8 dan Windows Server 2012, karena fungsi ini telah dihapus.
Reserved
Harus NULL.
Mengembalikan nilai
Fungsi mengembalikan handel ke kumpulan informasi perangkat kosong jika berhasil. Jika tidak, ia mengembalikan INVALID_HANDLE_VALUE. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.
Keterangan
Pemanggil fungsi ini harus menghapus informasi perangkat yang dikembalikan yang ditetapkan ketika tidak lagi diperlukan dengan memanggil SetupDiDestroyDeviceInfoList.
Jika set informasi perangkat adalah untuk perangkat di komputer jarak jauh (MachineName bukan NULL), semua operasi berikutnya pada set ini atau salah satu elemennya harus menggunakan rutinitas yang mendukung kumpulan informasi perangkat dengan elemen jarak jauh. Rutinitas SetupDiXxx yang tidak menyediakan dukungan ini, seperti SetupDiCallClassInstaller, memiliki pernyataan untuk efek tersebut di halaman referensi mereka.
Catatan
Header setupapi.h mendefinisikan SetupDiCreateDeviceInfoListEx 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 | Tersedia di Microsoft Windows 2000 dan versi Windows yang lebih baru. |
| Target Platform | Desktop |
| Header | setupapi.h (termasuk Setupapi.h) |
| Pustaka | Setupapi.lib |