Функция SetupDiOpenClassRegKeyExA (setupapi.h)
Функция установки SetupDiOpenClassRegKeyEx открывает раздел реестра класса установки устройства раздел реестра, класс интерфейса устройства раздела реестра или подраздел определенного класса. Эта функция открывает указанный ключ на локальном компьютере или на удаленном компьютере.
Синтаксис
WINSETUPAPI HKEY SetupDiOpenClassRegKeyExA(
[in, optional] const GUID *ClassGuid,
[in] REGSAM samDesired,
[in] DWORD Flags,
[in, optional] PCSTR MachineName,
PVOID Reserved
);
Параметры
[in, optional] ClassGuid
Указатель на GUID класса, раздел реестра которого должен быть открыт. Этот параметр является необязательным и может быть null. Если этот параметр null, открывается корневой каталог дерева классов (HKLM\SYSTEM\CurrentControlSet\Control\Class).
[in] samDesired
Доступ к безопасности реестра для открытия ключа. Сведения о значениях доступа к безопасности реестра типа REGSAM см. в документации по пакету SDK для Microsoft Windows.
[in] Flags
Тип открываемого раздела реестра, который указывается одним из следующих элементов:
DIOCR_INSTALLER
Откройте ключ класса установки. Если ClassGuidNULL, откройте корневой ключ ветви установщика классов.
DIOCR_INTERFACE
Откройте ключ класса интерфейса. Если ClassGuidNULL, откройте корневой ключ ветви класса интерфейса.
[in, optional] MachineName
При необходимости указывает на строку, содержащую имя удаленного компьютера, на котором следует открыть указанный ключ.
Осторожность
Эта функция для доступа к удаленным компьютерам не поддерживается начиная с Windows 8 и Windows Server 2012, так как эта функция была удалена.
Reserved
Скрытный. Должен быть null.
Возвращаемое значение
SetupDiOpenClassRegKeyEx возвращает дескриптор в открытый раздел реестра, где сведения об этом классе установки можно хранить и извлекать.
Если функция завершается ошибкой, она возвращает INVALID_HANDLE_VALUE. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.
Замечания
В зависимости от значения, переданного в параметре samDesired, может потребоваться для того, чтобы вызывающий объект этой функции был членом группы "Администраторы".
SetupDiOpenClassRegKeyEx не создает раздел реестра, если он еще не существует.
Вызывающие функции должны закрыть дескриптор, возвращаемый из этой функции, путем вызова RegCloseKey.
Заметка
Заголовок setupapi.h определяет SetupDiOpenClassRegKeyEx в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно в Microsoft Windows 2000 и более поздних версиях Windows. |
| целевая платформа | Настольный |
| заголовка | setupapi.h (include Setupapi.h) |
| библиотеки |
Setupapi.lib |