fungsi CM_Get_Child (cfgmgr32.h)

Artikel
03/08/2023

Fungsi CM_Get_Child digunakan untuk mengambil handel instans perangkat ke simpul anak pertama dari simpul perangkat tertentu (devnode) di pohon perangkat komputer lokal.

Catatan

Di Windows Vista dan versi Windows yang lebih baru, model properti perangkat terpadu menggunakan kunci properti DEVPKEY_Device_Children untuk mewakili turunan perangkat. Lihat Mengambil Hubungan Perangkat untuk detailnya.

Sintaks

CMAPI CONFIGRET CM_Get_Child(
  [out] PDEVINST pdnDevInst,
  [in]  DEVINST  dnDevInst,
  [in]  ULONG    ulFlags
);

Parameter

[out] pdnDevInst

Penunjuk yang disediakan penelepon ke handel instans perangkat ke simpul anak yang diambil fungsi ini. Handel yang diambil terikat ke komputer lokal. Lihat bagian Keterangan .

[in] dnDevInst

Handel instans perangkat yang disediakan penelepon yang terikat ke komputer lokal.

[in] ulFlags

Tidak digunakan, harus nol.

Menampilkan nilai

Jika operasi berhasil, fungsi akan mengembalikan CR_SUCCESS. Jika tidak, ia mengembalikan salah satu kode kesalahan awalan CR_ yang ditentukan dalam Cfgmgr32.h.

Keterangan

Untuk menghitung semua anak devnode di pohon perangkat komputer lokal, pertama-tama panggil CM_Get_Child untuk mendapatkan handel instans perangkat ke simpul anak pertama, lalu panggil CM_Get_Sibling untuk mendapatkan handel untuk anak-anak lainnya.

Menggunakan Handel Instans Perangkat

Handel instans perangkat yang Anda gunakan dengan fungsi manajer konfigurasi PnP terikat ke handel mesin, sebagai berikut:

Semua handel instans perangkat lokal terikat ke handel komputer lokal bernilai NULL.
Jika Anda menggunakan handel komputer jarak jauh untuk mendapatkan handel instans perangkat, handel instans perangkat jarak jauh yang dihasilkan terikat ke handel komputer jarak jauh.
Handel instans perangkat hanya dapat digunakan dengan handel mesin yang terikat.
Handel instans perangkat dapat digunakan dengan handel instans perangkat lain hanya jika kedua handel instans perangkat terikat ke handel komputer yang sama.

Untuk mendapatkan handel instans perangkat yang terikat ke komputer lokal, lakukan salah satu hal berikut ini.

Gunakan salah satu fungsi berikut yang hanya mengambil handel instans perangkat lokal: CM_Locate_DevNode, CM_Get_Child, CM_Get_Parent, atau CM_Get_Sibling.
Gunakan salah satu fungsi berikut, yang mengambil handel instans perangkat lokal dan jarak jauh, untuk mengambil handel instans perangkat lokal: CM_Locate_DevNode_Ex, CM_Get_Child_Ex, CM_Get_Parent_Ex, atau CM_Get_Sibling_Ex.

Anda juga dapat menggunakan fungsi penginstalan perangkat untuk mendapatkan handel instans perangkat lokal dari kumpulan informasi perangkat yang terikat ke komputer lokal. Lakukan langkah-langkah berikut:

Dapatkan set informasi perangkat yang terikat ke komputer lokal. (Handel instans perangkat yang diperoleh dari kumpulan informasi perangkat terikat ke handel komputer tempat kumpulan informasi perangkat terikat. Anda mendapatkan handel mesin untuk informasi perangkat yang ditetapkan dari anggota RemoteMachineHandle dari struktur SP_DEVINFO_LIST_DETAIL_DATA-nya . Untuk set informasi perangkat lokal yang terikat ke komputer lokal, nilai RemoteMachineHandle adalah NULL. Panggil SetupDiGetDeviceInfoListDetail untuk mendapatkan struktur SP_DEVINFO_LIST_DETAIL_DATA.)
Dapatkan struktur SP_DEVINFO_DATA untuk instans perangkat dalam kumpulan informasi perangkat.
Dapatkan handel instans perangkat untuk instans perangkat dari anggota DevInst dari struktur SP_DEVINFO_DATA.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Microsoft Windows 2000 dan versi Windows yang lebih baru.
Target Platform	Universal
Header	cfgmgr32.h (termasuk Cfgmgr32.h)
Pustaka	Cfgmgr32.lib; OneCoreUAP.lib di Windows 10
DLL	CfgMgr32.dll