fungsi CM_Locate_DevNodeW (cfgmgr32.h)
Fungsi CM_Locate_DevNode mendapatkan handel instans perangkat ke simpul perangkat yang terkait dengan ID instans perangkat tertentu pada komputer lokal.
Sintaks
CMAPI CONFIGRET CM_Locate_DevNodeW(
[out] PDEVINST pdnDevInst,
[in, optional] DEVINSTID_W pDeviceID,
[in] ULONG ulFlags
);
Parameter
[out] pdnDevInst
Penunjuk ke handel instans perangkat yang CM_Locate_DevNode ambil. Handel yang diambil terikat ke komputer lokal.
[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 mengambil handel instans perangkat ke perangkat di akar pohon perangkat.
[in] ulFlags
Variabel jenis ULONG yang menyediakan 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 ini mengambil handel instans perangkat untuk perangkat yang ditentukan jika perangkat saat ini dikonfigurasi di pohon perangkat atau perangkat adalah perangkat nonpresent 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 dari pohon perangkat. Jika perangkat sedang dalam proses dihapus, fungsi membatalkan penghapusan perangkat.
CM_LOCATE_DEVNODE_NOVALIDATION
Tidak digunakan.
Nilai kembali
Jika operasi berhasil, CM_Locate_DevNode mengembalikan CR_SUCCESS. Jika tidak, fungsi mengembalikan salah satu kode kesalahan CR_Xxx yang ditentukan dalam Cfgmgr32.h.
Keterangan
Untuk informasi tentang menggunakan handel instans perangkat yang terikat ke komputer lokal, lihat CM_Get_Child.
Catatan
Header cfgmgr32.h mendefinisikan CM_Locate_DevNode sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.
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 |
| DLL | CfgMgr32.dll |