CM_Get_Depth_Ex (cfgmgr32.h)

Artikel
02/28/2024

[Dimulai dengan Windows 8 dan Windows Server 2012, fungsi ini tidak digunakan lagi. Gunakan CM_Get_Depth sebagai gantinya.]

Fungsi CM_Get_Depth_Ex digunakan untuk mendapatkan kedalaman simpul perangkat tertentu (devnode) dalam pohon perangkat komputer lokal atau jarak jauh.

Sintaks

CMAPI CONFIGRET CM_Get_Depth_Ex(
  [out]          PULONG   pulDepth,
  [in]           DEVINST  dnDevInst,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

Parameter

[out] pulDepth

Alamat lokasi yang disediakan penelepon untuk menerima nilai kedalaman, di mana nol mewakili simpul akar pohon perangkat, satu mewakili anak-anak simpul akar, dan sebagainya.

[in] dnDevInst

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

[in] ulFlags

Tidak digunakan, harus nol.

[in, optional] hMachine

Handel mesin yang disediakan penelepon yang ditangani 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, kode kesalahan mengembalikan salah satu kode kesalahan awalan CR_ yang ditentukan dalam Cfgmgr32.h.

Keterangan

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_Depth

Bagikan melalui