CM_Reenumerate_DevNode_Ex (cfgmgr32.h)
[Dimulai dengan Windows 8 dan Windows Server 2012, fungsi ini tidak digunakan lagi. Silakan gunakan CM_Reenumerate_DevNode sebagai gantinya.]
Fungsi CM_Reenumerate_DevNode_Ex menghitung perangkat yang diidentifikasi oleh simpul perangkat tertentu dan semua turunannya.
Sintaks
CMAPI CONFIGRET CM_Reenumerate_DevNode_Ex(
[in] DEVINST dnDevInst,
[in] ULONG ulFlags,
[in, optional] HMACHINE hMachine
);
Parameter
[in] dnDevInst
Handel instans perangkat yang disediakan penelepon yang terikat ke handel mesin yang disediakan oleh hMachine.
[in] ulFlags
Bendera yang disediakan penelepon yang menentukan bagaimana reenumerasi harus terjadi. Parameter ini dapat diatur ke kombinasi bendera berikut, seperti yang disebutkan:
CM_REENUMERATE_ASYNCHRONOUS
Reenumerasi harus terjadi secara asinkron. Panggilan ke fungsi ini kembali segera setelah manajer PnP menerima permintaan reenumerasi. Jika bendera ini diatur, bendera CM_REENUMERATE_SYNCHRONOUS juga tidak boleh diatur.
CM_REENUMERATE_NORMAL
Menentukan perilaku reenumerasi default, di mana reenumerasi terjadi secara sinkron. Bendera ini saat ini setara dengan CM_REENUMERATE_SYNCHRONOUS.
CM_REENUMERATE_RETRY_INSTALLATION
Menentukan bahwa Plug and Play harus melakukan upaya lain untuk menginstal perangkat apa pun dalam subtree yang ditentukan yang telah terdeteksi tetapi belum dikonfigurasi, atau ditandai sebagai memerlukan penginstalan ulang, atau penginstalan mana yang harus diselesaikan. Bendera ini dapat diatur bersama dengan bendera CM_REENUMERATE_SYNCHRONOUS atau bendera CM_REENUMERATE_ASYNCHRONOUS.
Bendera ini harus digunakan dengan sangat hati-hati, karena dapat menyebabkan manajer PnP meminta pengguna untuk melakukan penginstalan perangkat tersebut. Saat ini, hanya komponen seperti Pengelola Perangkat dan Wizard Perangkat Keras yang menggunakan bendera ini, untuk memungkinkan pengguna mencoba kembali penginstalan perangkat yang mungkin sudah terdeteksi tetapi saat ini tidak diinstal.
CM_REENUMERATE_SYNCHRONOUS
Reenumerasi harus terjadi secara sinkron. Panggilan ke fungsi ini kembali ketika semua perangkat dalam subtree yang ditentukan telah dienumerasi ulang. Jika bendera ini diatur, bendera CM_REENUMERATE_ASYNCHRONOUS juga tidak boleh diatur. Bendera ini saat ini setara dengan CM_REENUMERATE_NORMAL.
[in, optional] hMachine
Handel mesin yang disediakan penelepon yang ditangani instans perangkat yang disediakan pemanggil terikat.
Menampilkan nilai
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
Jika simpul perangkat yang ditentukan mewakili perangkat keras atau bus perangkat lunak, manajer PnP meminta driver perangkat untuk daftar turunan, maka mencoba mengonfigurasi dan memulai perangkat anak apa pun yang sebelumnya tidak dikonfigurasi. Manajer PnP juga memulai penghapusan kejutan perangkat yang tidak lagi ada (lihat IRP_MN_SURPRISE_REMOVAL).
Penelepon fungsi ini harus memiliki SeLoadDriverPrivilege. (Hak istimewa dijelaskan dalam dokumentasi Microsoft Windows SDK.)
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
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk