CM_Setup_DevNode (cfgmgr32.h)

Artikel
08/22/2023

Fungsi CM_Setup_DevNode memulai ulang instans perangkat yang tidak berjalan karena ada masalah dengan konfigurasi perangkat.

Sintaks

CMAPI CONFIGRET CM_Setup_DevNode(
  [in] DEVINST dnDevInst,
  [in] ULONG   ulFlags
);

Parameter

[in] dnDevInst

Handel instans perangkat yang terikat ke sistem lokal.

[in] ulFlags

Salah satu nilai bendera berikut:

CM_SETUP_DEVNODE_READY

Menghidupkan ulang instans perangkat yang tidak berjalan karena masalah dengan konfigurasi perangkat.

CM_SETUP_DEVNODE_RESET (Windows XP dan versi Windows yang lebih baru)

Mengatur ulang instans perangkat yang tidak memiliki bendera status perangkat hidupkan ulang yang ditetapkan. Bendera status perangkat hidupkan ulang tidak diatur jika perangkat dihapus dengan memanggil CM_Query_And_Remove_SubTree atau CM_Query_And_Remove_SubTree_Ex dan menentukan bendera CM_REMOVE_NO_RESTART.

Mengembalikan nilai

Jika operasi berhasil, fungsi akan mengembalikan CR_SUCCESS. Jika tidak, ia mengembalikan salah satu kode kesalahan dengan awalan "CR_" yang ditentukan dalam Cfgmgr32.h.

Keterangan

Aplikasi penginstalan perangkat harus menggunakan permintaan DIF_PROPERTYCHANGE untuk memulai ulang perangkat alih-alih menggunakan fungsi ini. Permintaan DIF_PROPERTYCHANGE dapat digunakan untuk mengaktifkan, menonaktifkan, menghidupkan ulang, menghentikan, atau mengubah properti perangkat.

Jika instans perangkat tidak memiliki masalah dan sudah dimulai, CM_Setup_DevNode kembali tanpa mengubah status instans perangkat.

Panggil CM_Get_DevNode_Status atau CM_Get_DevNode_Status_Ex untuk menentukan status dan kode masalah untuk instans perangkat.

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; OneCoreUAP.lib di Windows 10
DLL	CfgMgr32.dll