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

Функция 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

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

SetupDiOpenClassRegKeyEx

SetupDiOpenDevRegKey