Функция SetupDiOpenClassRegKey (setupapi.h)
Функция SetupDiOpenClassRegKey открывает раздел реестра класса установки или подраздел определенного класса.
Синтаксис
WINSETUPAPI HKEY SetupDiOpenClassRegKey(
[in, optional] const GUID *ClassGuid,
[in] REGSAM samDesired
);
Параметры
[in, optional] ClassGuid
Указатель на GUID класса установки, ключ которого необходимо открыть. Этот параметр является необязательным и может иметь значение NULL. Если этот параметр имеет значение NULL, открывается корень дерева класса установки (HKLM\SYSTEM\CurrentControlSet\Control\Class).
[in] samDesired
Доступ к системе безопасности реестра для открываемого раздела. Сведения о значениях доступа к системе безопасности реестра типа REGSAM см. в документации по Microsoft Windows SDK.
Возвращаемое значение
Если функция выполнена успешно, она возвращает дескриптор открытого раздела реестра, где можно хранить или извлекать сведения об этом классе установки.
Если функция завершается сбоем, она возвращает INVALID_HANDLE_VALUE. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.
Комментарии
В зависимости от значения, передаваемого в параметре samDesired , может потребоваться, чтобы вызывающий объект этой функции был членом группы Администраторы.
Эта функция не создает раздел реестра, если он еще не существует.
Дескриптор, возвращаемый этой функцией, должен быть закрыт путем вызова RegCloseKey.
Чтобы открыть раздел реестра класса интерфейса или определенный подраздел класса интерфейса, вызовите SetupDiOpenClassRegKeyEx.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно в Microsoft Windows 2000 и более поздних версиях Windows. |
| Целевая платформа | DesktopДля универсального, вызовите CM_Open_Class_Key |
| Верхняя часть | setupapi.h (включая Setupapi.h) |
| Библиотека | Setupapi.lib |
| DLL | Setupapi.dll |