Функция 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)
Библиотека Setupapi.lib
DLL Setupapi.dll

См. также раздел

SetupDiCreateDeviceInfo

SetupDiEnumDeviceInfo

SetupDiGetWizardPage

SetupDiOpenDeviceInfo