fungsi CM_Get_Sibling (cfgmgr32.h)
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 |