функция CM_Open_Class_KeyW (cfgmgr32.h)
Функция CM_Open_Class_Key открывает раздел реестра класса настройки устройства, раздел реестра класса интерфейса устройства или определенный подраздел класса.
Синтаксис
CMAPI CONFIGRET CM_Open_Class_KeyW(
[in, optional] LPGUID ClassGuid,
[in, optional] LPCWSTR pszClassName,
[in] REGSAM samDesired,
[in] REGDISPOSITION Disposition,
[out] PHKEY phkClass,
[in] ULONG ulFlags
);
Параметры
[in, optional] ClassGuid
Указатель на GUID класса, раздел реестра которого необходимо открыть. Этот параметр является необязательным и может иметь значение NULL. Если этот параметр имеет значение NULL, открывается корень дерева классов.
[in, optional] pszClassName
Зарезервировано. Для параметра должно быть задано значение NULL.
[in] samDesired
Доступ к системе безопасности реестра для открываемого раздела.
[in] Disposition
Указывает способ открытия раздела реестра. Может иметь одно из следующих значений:
RegDisposition_OpenAlways
Откройте ключ, если он существует. В противном случае создайте ключ.
RegDisposition_OpenExisting
Открывайте ключ только в том случае, если он существует.
[out] phkClass
Указатель на ключ HKEY, который получит открытый ключ после успешного выполнения.
[in] ulFlags
Открытые флаги ключа класса:
CM_OPEN_CLASS_KEY_INSTALLER
Ключ, который необходимо открыть, предназначен для класса настройки устройства.
CM_OPEN_CLASS_KEY_INTERFACE
Ключ, который необходимо открыть, предназначен для класса интерфейса устройства.
Возвращаемое значение
Если операция выполнена успешно, функция возвращает CR_SUCCESS. В противном случае возвращается один из кодов ошибок с префиксом CR_, определенных в Cfgmgr32.h.
Комментарии
Закройте дескриптор, возвращенный этой функцией, вызвав RegCloseKey.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно в Microsoft Windows 2000 и более поздних версиях Windows. |
| Целевая платформа | Персональный компьютер |
| Верхняя часть | cfgmgr32.h (включая Cfgmgr32.h) |
| Библиотека | Cfgmgr32.lib |