fungsi CM_Get_Sibling_Ex (cfgmgr32.h)

Artikel
03/04/2024

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

Fungsi CM_Get_Sibling_Ex mendapatkan handel instans perangkat ke simpul saudara berikutnya dari simpul perangkat tertentu, di pohon perangkat komputer lokal atau jarak jauh.

Sintaks

CMAPI CONFIGRET CM_Get_Sibling_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 saudara yang diambil fungsi ini. Handel yang diambil terikat ke handel mesin yang ditentukan oleh hMachine.

[in] dnDevInst

Handel instans perangkat yang disediakan pemanggil yang terikat ke handel mesin yang ditentukan 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.

Nilai kembali

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 simpul perangkat di pohon perangkat komputer lokal, 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.

Untuk informasi tentang menggunakan handel instans perangkat yang terikat ke komputer lokal atau jarak jauh, lihat CM_Get_Child_Ex.

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

Lihat juga

CM_Get_Child_Ex

CM_Get_Sibling

Bagikan melalui