CM_Setup_DevNode 函数 (cfgmgr32.h)

CM_Setup_DevNode函数会重启未运行的设备实例，因为设备配置存在问题。

语法

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

[in] dnDevInst

绑定到本地系统的设备实例句柄。

[in] ulFlags

以下标志值之一：

重启因设备配置问题而未运行的设备实例。

重置未设置“未重启设备状态”标志的设备实例。如果通过调用CM_Query_And_Remove_SubTree或CM_Query_And_Remove_SubTree_Ex并指定CM_REMOVE_NO_RESTART标志来删除设备，则不设置重启设备状态标志。

如果操作成功，函数将返回CR_SUCCESS。否则，它将返回 Cfgmgr32.h 中定义的带有“CR_”前缀的错误代码之一。

设备安装应用程序应使用 DIF_PROPERTYCHANGE 请求重启设备，而不是使用此函数。 DIF_PROPERTYCHANGE请求可用于启用、禁用、重启、停止或更改设备的属性。

如果设备实例没有问题并且已启动， 则CM_Setup_DevNode 返回，而不会更改设备实例的状态。

调用 CM_Get_DevNode_Status 或 CM_Get_DevNode_Status_Ex 以确定设备实例的状态和问题代码。


最低受支持的客户端	在 Microsoft Windows 2000 及更高版本的 Windows 中可用。
目标平台	通用
标头	cfgmgr32.h (包括 Cfgmgr32.h)
Library	Cfgmgr32.lib;Windows 10 上的 OneCoreUAP.lib
DLL	CfgMgr32.dll