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。 否则,它将返回 Cfgmgr32.h 中定义的带有“CR_”前缀的错误代码之一。

备注

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

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

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

要求

   
最低受支持的客户端 在 Microsoft Windows 2000 及更高版本的 Windows 中可用。
目标平台 通用
标头 cfgmgr32.h (包括 Cfgmgr32.h)
Library 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