fungsi CM_Locate_DevNodeA (cfgmgr32.h)

  • Artikel

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_DevNodeA(
  [out]          PDEVINST    pdnDevInst,
  [in, optional] DEVINSTID_A 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.

Mengembalikan nilai

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

   
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

Lihat juga

CM_Get_Child

CM_Locate_DevNode_Ex