CM_Setup_DevNode函式 (cfgmgr32.h)
CM_Setup_DevNode函式會重新開機未執行的裝置實例,因為裝置設定發生問題。
語法
CMAPI CONFIGRET CM_Setup_DevNode(
[in] DEVINST dnDevInst,
[in] ULONG ulFlags
);
參數
[in] dnDevInst
系結至本機系統的裝置實例控制碼。
[in] ulFlags
下列其中一個旗標值:
CM_SETUP_DEVNODE_READY
重新開機裝置實例,因為裝置組態發生問題而未執行。
CM_SETUP_DEVNODE_RESET (Windows XP 和更新版本的 Windows)
重設未設定重新開機裝置狀態旗標的裝置實例。 如果裝置已藉由呼叫 CM_Query_And_Remove_SubTree 或 CM_Query_And_Remove_SubTree_Ex 並指定 CM_REMOVE_NO_RESTART 旗標來移除裝置,則不會設定重新開機裝置狀態旗標。
傳回值
如果作業成功,函式會傳回CR_SUCCESS。 否則,它會傳回其中一個錯誤碼,其中一個錯誤碼的 「CR_」 前置詞定義于 Cfgmgr32.h中。
備註
裝置安裝應用程式 應該使用 DIF_PROPERTYCHANGE 要求來重新開機裝置,而不是使用此函式。 DIF_PROPERTYCHANGE要求可用來啟用、停用、重新開機、停止或變更裝置的屬性。
如果裝置實例沒有問題且已經啟動, CM_Setup_DevNode 會傳回而不變更裝置實例的狀態。
呼叫 CM_Get_DevNode_Status 或 CM_Get_DevNode_Status_Ex ,以判斷裝置實例的狀態和問題碼。
規格需求
最低支援的用戶端 | 可在 Microsoft Windows 2000 和更新版本的 Windows 中使用。 |
目標平台 | Universal |
標頭 | cfgmgr32.h (包含 Cfgmgr32.h) |
程式庫 | Cfgmgr32.lib;Windows 10 上的 OneCoreUAP.lib |
Dll | CfgMgr32.dll |