Поделиться через

Функция SetupDiDeleteDeviceInterfaceRegKey (setupapi.h)

  • Статья

Функция SetupDiDeleteDeviceInterfaceRegKey удаляет подраздел реестра, который используется приложениями и драйверами для хранения сведений, относящихся к интерфейсу.

Синтаксис

WINSETUPAPI BOOL SetupDiDeleteDeviceInterfaceRegKey(
  [in] HDEVINFO                  DeviceInfoSet,
  [in] PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData,
       DWORD                     Reserved
);

Параметры

[in] DeviceInfoSet

Указатель на набор сведений об устройстве , содержащий интерфейс, для которого требуется удалить сведения, относящиеся к интерфейсу, в реестре. Набор сведений об устройстве не должен содержать удаленные элементы.

[in] DeviceInterfaceData

Указатель на структуру SP_DEVICE_INTERFACE_DATA , указывающую интерфейс устройства в DeviceInfoSet. Возможно, этот указатель возвращается методом SetupDiCreateDeviceInterface или SetupDiEnumDeviceInterfaces.

Reserved

Зарезервировано. Должен равняться нулю.

Возвращаемое значение

SetupDiDeleteDeviceInterfaceRegKey возвращает значение TRUE в случае успешного выполнения. В противном случае возвращается значение FALSE , и зарегистрированная ошибка может быть получена с помощью вызова Метода GetLastError.

Комментарии

Вызывающий объект этой функции должен быть членом группы Администраторы.

SetupDiDeleteDeviceInterfaceRegKey удаляет подраздел, используемый драйверами и приложениями для хранения сведений об экземпляре интерфейса устройства. Этот подраздел был создан с помощью SetupDiCreateDeviceInterfaceRegKey или вызова драйвера связанной подпрограммы диспетчера ввода-вывода. SetupDiDeleteDeviceInterfaceRegKey не влияет на main раздел реестра для экземпляра интерфейса устройства и другие подразделы, которые могли быть созданы.

DeviceInfoSet должен содержать только элементы на локальном компьютере.

Требования

Требование Значение
Минимальная версия клиента Доступно в Microsoft Windows 2000 и более поздних версиях Windows.
Целевая платформа Персональный компьютер
Верхняя часть setupapi.h (включая Setupapi.h)
Библиотека Setupapi.lib
DLL Setupapi.dll

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

SetupDiCreateDeviceInterface

SetupDiCreateDeviceInterfaceRegKey