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

另请参阅

SetupDiCreateDeviceInfo

SetupDiEnumDeviceInfo

SetupDiGetWizardPage

SetupDiOpenDeviceInfo