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_Status 或 CM_Get_DevNode_Status_Ex 以确定设备实例的状态和问题代码。
要求
最低受支持的客户端 | 在 Microsoft Windows 2000 及更高版本的 Windows 中可用。 |
目标平台 | 通用 |
标头 | cfgmgr32.h (包括 Cfgmgr32.h) |
Library | Cfgmgr32.lib;Windows 10 上的 OneCoreUAP.lib |
DLL | CfgMgr32.dll |