setupDiUnremoveDevice 函数 (setupapi.h)

  • 项目

SetupDiUnremoveDevice 函数是DIF_UNREMOVE安装请求的默认处理程序。

语法

WINSETUPAPI BOOL SetupDiUnremoveDevice(
  [in]      HDEVINFO         DeviceInfoSet,
  [in, out] PSP_DEVINFO_DATA DeviceInfoData
);

参数

[in] DeviceInfoSet

本地系统 的设备信息集 的句柄，其中包含表示要还原和重启的设备的设备信息元素。

[in, out] DeviceInfoData

指向 SP_DEVINFO_DATA 结构的指针，该结构指定 DeviceInfoSet 中的设备信息元素。 这是 IN-OUT 参数，因为 DeviceInfoData。DevInst 可能会在返回时使用新的句柄值进行更新。

返回值

如果成功，函数将返回 TRUE 。 否则，它将返回 FALSE ，并且可以通过调用 GetLastError 来检索记录的错误。

注解

SetupDiUnremoveDevice 将设备还原到硬件配置文件。 如果可能，此函数会启动设备，或者在设备安装参数中设置标志，最终提示用户关闭系统。

注意 只有类安装程序应调用 SetupDiUnremoveDevice ，并且仅在类安装程序必须在 SetupDiUnremoveDevice 完成默认设备取消移动操作后执行设备取消移动操作的情况下调用。 在这种情况下，当安装程序处理DIF_UNREMOVE请求时，类安装程序必须直接调用 SetupDiUnremoveDevice 。 有关调用默认处理程序的详细信息，请参阅 调用默认 DIF 代码处理程序。
 
正在还原的设备必须具有 DIF_UNREMOVE 的类安装参数，否则函数将失败， GetLastError 将返回ERROR_NO_CLASSINSTALL_PARAMS。

DeviceInfoSet 只能包含本地计算机上的元素。

SetupDiUnremoveDevice 的调用方必须是 Administrators 组的成员。

要求

要求 值
最低受支持的客户端 在 Microsoft Windows 2000 及更高版本的 Windows 中可用。
目标平台 桌面
标头 setupapi.h (包括 Setupapi.h)
Library Setupapi.lib
DLL Setupapi.dll

另请参阅

DIF_UNREMOVE

SP_DEVINFO_DATA

SetupDiRemoveDevice