Функция SetupDiRemoveDeviceInterface (setupapi.h)
Функция SetupDiRemoveDeviceInterface удаляет из системы зарегистрированный интерфейс устройства.
Синтаксис
WINSETUPAPI BOOL SetupDiRemoveDeviceInterface(
[in] HDEVINFO DeviceInfoSet,
[in, out] PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData
);
Параметры
[in] DeviceInfoSet
Указатель на набор сведений об устройстве , содержащий удаляемую интерфейс устройства. Этот дескриптор обычно возвращается setupDiGetClassDevs.
[in, out] DeviceInterfaceData
Указатель на структуру SP_DEVICE_INTERFACE_DATA , указывающую интерфейс устройства в DeviceInfoSet для удаления. Этот указатель обычно возвращается setupDiEnumDeviceInterfaces.
После удаления интерфейса эта функция устанавливает флаг SPINT_REMOVED в DeviceInterfaceData. Флаги. Он также очищает флаг SPINT_ACTIVE, но имейте в виду, что этот флаг уже должен был быть снят до вызова этой функции.
Возвращаемое значение
SetupDiRemoveDeviceInterface возвращает значение TRUE , если функция выполнена без ошибок. Если функция завершилась ошибкой, она возвращает значение FALSE , и код ошибки для сбоя можно получить, вызвав Метод GetLastError.
Комментарии
Вызывающий объект этой функции должен быть членом группы Администраторы.
SetupDiRemoveDeviceInterface удаляет указанный интерфейс устройства из системы. Сюда входит удаление связанного раздела реестра.
Вызовите SetupDiDeleteDeviceInterfaceData , чтобы удалить интерфейс из списка сведений об устройствах.
Чтобы удалить интерфейс устройства, его необходимо отключить. Если интерфейс включен, эта функция завершается сбоем, и GetLastError возвращает ERROR_DEVICE_INTERFACE_ACTIVE. Отключите интерфейс, используя любой механизм, зависящий от интерфейса (например, IOCTL). Если вызывающий объект не может отключить интерфейс и его необходимо удалить, вызывающий объект должен остановить базовое устройство с помощью SetupDiChangeStateState. Остановка устройства отключает все интерфейсы, предоставляемые устройством.
Требования
| Минимальная версия клиента | Доступно в Microsoft Windows 2000 и более поздних версиях Windows. |
| Целевая платформа | Персональный компьютер |
| Верхняя часть | setupapi.h (включая Setupapi.h) |
| Библиотека | Setupapi.lib |
| DLL | Setupapi.dll |