Fungsi SetupDiGetDeviceInfoListDetailA (setupapi.h)

Fungsi SetupDiGetDeviceInfoListDetail mengambil informasi yang terkait dengan set informasi perangkat termasuk GUID kelas, handel komputer jarak jauh, dan nama komputer jarak jauh.

Sintaksis

WINSETUPAPI BOOL SetupDiGetDeviceInfoListDetailA(
  [in]  HDEVINFO                       DeviceInfoSet,
  [out] PSP_DEVINFO_LIST_DETAIL_DATA_A DeviceInfoSetDetailData
);

Parameter

[in] DeviceInfoSet

Handel ke kumpulan informasi perangkat untuk mengambil informasi.

[out] DeviceInfoSetDetailData

Penunjuk ke struktur SP_DEVINFO_LIST_DETAIL_DATA yang diinisialisasi penelepon yang menerima informasi set informasi perangkat. Untuk informasi selengkapnya tentang struktur ini, lihat bagian Keterangan berikut ini.

Mengembalikan nilai

Fungsi mengembalikan TRUE jika berhasil. Jika tidak, ini mengembalikan FALSE dan kesalahan yang dicatat dapat diambil dengan melakukan panggilan ke GetLastError.

Komentar

Jika parameter valid, SetupDiGetDeviceInfoListDetail menetapkan nilai dalam struktur DeviceInfoSetDetailData (kecuali untuk bidang cbSize) dan mengembalikan status NO_ERROR.

Pemanggil SetupDiGetDeviceInfoListDetail harus mengatur DeviceInfoSetDetailData. cbSize untuk ukuran(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 set 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, itu 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 NULL dan DeviceInfoSetDetailData.RemoteMachineName adalah string kosong.

Nota

Header setupapi.h mendefinisikan SetupDiGetDeviceInfoListDetail sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosem 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	Tersedia di Microsoft Windows 2000 dan versi Windows yang lebih baru.
Platform Target	Desktop
Header	setupapi.h (termasuk Setupapi.h)
Pustaka	Setupapi.lib

Lihat juga

SetupDiCreateDeviceInfoListEx

SetupDiGetClassDevsEx

SetupDiGetDeviceInfoListClass