共用方式為


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_StatusCM_Get_DevNode_Status_Ex ,以判斷裝置實例的狀態和問題碼。

規格需求

   
最低支援的用戶端 可在 Microsoft Windows 2000 和更新版本的 Windows 中使用。
目標平台 Universal
標頭 cfgmgr32.h (包含 Cfgmgr32.h)
程式庫 Cfgmgr32.lib;Windows 10 上的 OneCoreUAP.lib
Dll CfgMgr32.dll

另請參閱

CM_Get_DevNode_Status

CM_Get_DevNode_Status_Ex

CM_Query_And_Remove_SubTree

CM_Query_And_Remove_SubTree_Ex

DIF_PROPERTYCHANGE