SetupDiDeleteDeviceInfo 函数 (setupapi.h)
SetupDiDeleteDeviceInfo 函数从设备信息集中删除设备信息元素。 此函数不会删除实际设备。
语法
WINSETUPAPI BOOL SetupDiDeleteDeviceInfo(
[in] HDEVINFO DeviceInfoSet,
[in] PSP_DEVINFO_DATA DeviceInfoData
);
参数
[in] DeviceInfoSet
包含要删除 的设备信息 元素的设备信息集的句柄。
[in] DeviceInfoData
指向 SP_DEVINFO_DATA 结构的指针，该结构表示 要删除的 DeviceInfoSet 中的设备信息元素。
返回值
如果成功，该函数将返回 TRUE 。 否则，它将返回 FALSE ，并且可以通过调用 GetLastError 来检索记录的错误。
注解
例如，如果指定的设备信息元素正在使用 (向导页) ，则函数将失败。 在这种情况下，对 GetLastError 的调用将返回ERROR_DEVINFO_DATA_LOCKED。 如果通过调用 SetupDiGetWizardPage 检索向导页的句柄，并指定了此设备信息元素并设置了DIWP_FLAG_USE_DEVINFO_DATA标志，则会发生这种情况。 若要删除此设备信息元素，必须先关闭向导的 HPROPSHEETPAGE 句柄。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 在 Microsoft Windows 2000 及更高版本的 Windows 中可用。 |
| 目标平台 | 桌面 |
| 标头 | setupapi.h (包括 Setupapi.h) |
| Library | Setupapi.lib |
| DLL | Setupapi.dll |