Fungsi SetupDiGetDeviceInfoListDetailW (setupapi.h)
Fungsi SetupDiGetDeviceInfoListDetail mengambil informasi yang terkait dengan kumpulan informasi perangkat termasuk GUID kelas, handel komputer jarak jauh, dan nama komputer jarak jauh.
Sintaks
WINSETUPAPI BOOL SetupDiGetDeviceInfoListDetailW(
[in] HDEVINFO DeviceInfoSet,
[out] PSP_DEVINFO_LIST_DETAIL_DATA_W DeviceInfoSetDetailData
);
Parameter
[in] DeviceInfoSet
Handel ke set informasi perangkat untuk mengambil informasi.
[out] DeviceInfoSetDetailData
Penunjuk ke struktur SP_DEVINFO_LIST_DETAIL_DATA yang diinisialisasi pemanggil yang menerima informasi set informasi perangkat. Untuk informasi selengkapnya tentang struktur ini, lihat bagian Keterangan berikut ini.
Nilai kembali
Fungsi mengembalikan TRUE jika berhasil. Jika tidak, kesalahan mengembalikan FALSE dan kesalahan yang dicatat dapat diambil dengan melakukan panggilan ke GetLastError.
Keterangan
Jika parameter valid, SetupDiGetDeviceInfoListDetail menetapkan nilai dalam struktur DeviceInfoSetDetailData (kecuali untuk bidang cbSize ) dan mengembalikan status NO_ERROR.
Penelepon SetupDiGetDeviceInfoListDetail harus mengatur DeviceInfoSetDetailData.cbSize ke sizeof(SP_DEVINFO_LIST_DETAIL_DATA) atau fungsi akan gagal dan panggilan ke GetLastError akan mengembalikan ERROR_INVALID_USER_BUFFER.
Jika SetupDiGetDeviceInfoListDetail berhasil diselesaikan, DeviceInfoSetDetailData.ClassGuid berisi GUID kelas yang terkait dengan kumpulan informasi perangkat atau struktur GUID_NULL.
Jika SetupDiGetDeviceInfoListDetail berhasil diselesaikan dan kumpulan informasi perangkat adalah untuk sistem jarak jauh, DeviceInfoSetDetailData.RemoteMachineHandle berisi handel sistem ConfigMgr32 untuk mengakses sistem jarak jauh dan DeviceInfoSetDetailData.RemoteMachineName berisi nama sistem jarak jauh. Jika ada handel jarak jauh untuk kumpulan informasi perangkat, handel tersebut harus digunakan saat memanggil fungsi CM_Xxx_Ex karena handel DevInst relatif terhadap handel jarak jauh.
Jika set informasi perangkat adalah untuk komputer lokal, DeviceInfoSetDetailData.RemoteMachineHandle adalah NULL dan DeviceInfoSetDetailData.RemoteMachineName adalah string kosong.
Catatan
Header setupapi.h mendefinisikan SetupDiGetDeviceInfoListDetail 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 |