CM_Locate_DevNode_ExW (cfgmgr32.h)

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

Fungsi CM_Locate_DevNode_Ex mendapatkan handel instans perangkat ke simpul perangkat yang terkait dengan ID instans perangkat tertentu, pada komputer lokal atau komputer jarak jauh.

Sintaks

CMAPI CONFIGRET CM_Locate_DevNode_ExW(
  [out]          PDEVINST    pdnDevInst,
  [in, optional] DEVINSTID_W pDeviceID,
  [in]           ULONG       ulFlags,
  [in, optional] HMACHINE    hMachine
);

Parameter

[out] pdnDevInst

Penunjuk ke instans perangkat menangani yang diambil fungsi ini. Handel yang diambil terikat ke handel komputer yang ditentukan oleh hMachine.

[in, optional] pDeviceID

Penunjuk ke string yang dihentikan NULL yang mewakili ID instans perangkat. Jika nilai ini NULL, atau jika menunjuk ke string panjang nol, fungsi menyediakan handel instans perangkat ke perangkat di akar pohon perangkat.

[in] ulFlags

Variabel jenis ULONG yang memasok salah satu nilai bendera berikut yang berlaku jika pemanggil menyediakan pengidentifikasi instans perangkat:

CM_LOCATE_DEVNODE_NORMAL

Fungsi ini mengambil handel instans perangkat untuk perangkat yang ditentukan hanya jika perangkat saat ini dikonfigurasi di pohon perangkat.

CM_LOCATE_DEVNODE_PHANTOM

Fungsi mengambil handel instans perangkat untuk perangkat yang ditentukan jika perangkat saat ini dikonfigurasi di pohon perangkat atau perangkat adalah perangkat yang tidak terwaktu yang saat ini tidak dikonfigurasi di pohon perangkat.

CM_LOCATE_DEVNODE_CANCELREMOVE

Fungsi ini mengambil handel instans perangkat untuk perangkat yang ditentukan jika perangkat saat ini dikonfigurasi di pohon perangkat atau dalam proses dihapus untuk pohon perangkat. Jika perangkat sedang dalam proses dihapus, fungsi membatalkan penghapusan perangkat.

CM_LOCATE_DEVNODE_NOVALIDATION

Tidak digunakan.

[in, optional] hMachine

Handel mesin yang diperoleh dari panggilan ke CM_Connect_Machine, atau handel mesin tempat kumpulan informasi perangkat terikat. Handel komputer untuk set informasi perangkat diperoleh dari anggota RemoteMachineHandle dari struktur SP_DEVINFO_LIST_DETAIL_DATA untuk kumpulan informasi perangkat. Panggil SetupDiGetDeviceInfoListDetail untuk mendapatkan struktur SP_DEVINFO_LIST_DETAIL_DATA.

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

 

Mengembalikan nilai

Jika operasi berhasil, CM_Locate_DevNode mengembalikan CR_SUCCESS. Jika tidak, fungsi 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

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

Lihat juga

CM_Get_Child_Ex

CM_Locate_DevNode