fungsi CM_Get_Sibling (cfgmgr32.h)

  • Artikel

Fungsi CM_Get_Sibling mendapatkan handel instans perangkat ke simpul saudara berikutnya 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 propertiDEVPKEY_Device_Siblings untuk mewakili saudara perangkat. Lihat Mengambil Hubungan Perangkat untuk detailnya.

Sintaks

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

Parameter

[out] pdnDevInst

Penunjuk yang disediakan penelepon ke handel instans perangkat ke simpul saudara yang diambil fungsi ini. Handel yang diambil terikat ke komputer lokal.

[in] dnDevInst

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

[in] ulFlags

Tidak digunakan, harus nol.

Nilai kembali

Jika operasi berhasil, fungsi akan mengembalikan CR_SUCCESS. Jika tidak, kode kesalahan 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 ke simpul anak pertama, lalu panggil CM_Get_Sibling untuk mendapatkan handel untuk anak-anak lainnya.

Untuk informasi tentang menggunakan handel instans perangkat yang terikat ke komputer lokal, lihat CM_Get_Child.

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

Lihat juga

CM_Get_Child

CM_Get_Sibling_Ex