fungsi CM_Get_Child_Ex (cfgmgr32.h)

Artikel
08/22/2023

[Dimulai dengan Windows 8 dan Windows Server 2012, fungsi ini tidak digunakan lagi. Silakan gunakan CM_Get_Child sebagai gantinya.]

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

Sintaks

CMAPI CONFIGRET CM_Get_Child_Ex(
  [out]          PDEVINST pdnDevInst,
  [in]           DEVINST  dnDevInst,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

Parameter

[out] pdnDevInst

Penunjuk yang disediakan penelepon ke handel instans perangkat ke simpul anak yang diambil fungsi ini. Handel yang diambil terikat ke handel mesin yang disediakan oleh hMachine. Lihat bagian Keterangan .

[in] dnDevInst

Handel instans perangkat yang disediakan pemanggil yang terikat ke handel mesin yang disediakan oleh hMachine.

[in] ulFlags

Tidak digunakan, harus nol.

[in, optional] hMachine

Handel mesin yang disediakan penelepon di mana handel instans perangkat yang disediakan pemanggil terikat.

Catatan Menggunakan fungsi ini untuk mengakses komputer jarak jauh tidak didukung dimulai dengan Windows 8 dan Windows Server 2012, karena fungsi ini telah dihapus.

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 atau jarak jauh, pertama-tama panggil CM_Get_Child_Ex untuk mendapatkan handel ke simpul anak pertama, lalu panggil CM_Get_Sibling_Ex 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.

Gunakan CM_Connect_Machine untuk mendapatkan handel komputer jarak jauh untuk digunakan dengan handel instans perangkat jarak jauh.

Untuk mendapatkan handel instans perangkat lokal atau jarak jauh, lakukan salah satu hal berikut ini.

Gunakan salah satu fungsi berikut untuk mengambil handel instans perangkat yang terikat ke komputer lokal: CM_Locate_DevNode, CM_Get_Child, CM_Get_Parent, atau CM_Get_Sibling.
Gunakan salah satu fungsi berikut untuk mengambil handel instans perangkat yang terikat ke komputer lokal atau jarak jauh: 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. Lakukan langkah-langkah berikut:

Dapatkan kumpulan informasi perangkat.
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.
Dapatkan handel mesin yang terikat dengan handel instans perangkat. 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 . (Panggil SetupDiGetDeviceInfoListDetail untuk mendapatkan struktur SP_DEVINFO_LIST_DETAIL_DATA.)

Fungsionalitas untuk mengakses komputer jarak jauh telah dihapus di Windows 8 dan Windows Server 2012 dan sistem operasi yang lebih baru sehingga Anda tidak dapat mengakses komputer jarak jauh saat berjalan pada versi Windows ini.

Persyaratan

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