Функция 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 |