Функция SetupDiDeleteDevRegKey (setupapi.h)
Функция SetupDiDeleteDevRegKey удаляет указанные доступные пользователю разделы реестра, связанные с элементом сведений об устройстве.
Синтаксис
WINSETUPAPI BOOL SetupDiDeleteDevRegKey(
[in] HDEVINFO DeviceInfoSet,
[in] PSP_DEVINFO_DATA DeviceInfoData,
[in] DWORD Scope,
[in] DWORD HwProfile,
[in] DWORD KeyType
);
Параметры
[in] DeviceInfoSet
Дескриптор набора сведений об устройстве , который содержит элемент сведений об устройстве, представляющий устройство, для которого требуется удалить разделы реестра. Набор сведений об устройстве не должен содержать удаленные элементы.
[in] DeviceInfoData
Указатель на структуру SP_DEVINFO_DATA , указывающую элемент сведений об устройстве в DeviceInfoSet.
[in] Scope
Область удаляемого раздела реестра. Область указывает, где находятся сведения. Ключ может быть глобальным или аппаратным профилем. Может иметь одно из следующих значений:
DICS_FLAG_GLOBAL
Удалите ключ, в котором хранятся сведения о глобальной конфигурации.
DICS_FLAG_CONFIGSPECIFIC
Удалите ключ, в котором хранятся сведения о конфигурации для конкретного профиля оборудования.
[in] HwProfile
Если для параметра Scope задано значение DICS_FLAG_CONFIGSPECIFIC, параметр HwProfile указывает профиль оборудования, для которого требуется удалить раздел реестра. Если HwProfile имеет значение 0, ключ для текущего профиля оборудования удаляется. Если HwProfile 0xFFFFFFFF, раздел реестра для всех профилей оборудования удаляется.
[in] KeyType
Тип удаляемого раздела хранилища реестра. Может иметь одно из следующих значений:
DIREG_DEV
Удалите аппаратный ключ устройства.
DIREG_DRV
Удалите программный ключ устройства.
DIREG_BOTH
Удалите аппаратные и программные ключи для устройства.
Возвращаемое значение
Функция возвращает ЗНАЧЕНИЕ TRUE , если оно выполнено успешно. В противном случае возвращается значение FALSE , а зарегистрированная ошибка может быть получена с помощью вызова Метода GetLastError.
Комментарии
Вызывающий объект этой функции должен быть членом группы Администраторы.
DeviceInfoSet должен содержать только элементы на локальном компьютере.
Требования
| Минимальная версия клиента | Доступно в Microsoft Windows 2000 и более поздних версиях Windows. |
| Целевая платформа | Персональный компьютер |
| Верхняя часть | setupapi.h (включая Setupapi.h) |
| Библиотека | Setupapi.lib |
| DLL | Setupapi.dll |