w32api - Справочник по Windows API
Найти:
На:





Функция RegOpenKey открывает указанный ключ. Эта функция оставленя для совместимости с Windows версии 3.1. Приложения для Win32 должны использовать функцию RegOpenKeyEx.

LONG RegOpenKey(
    HKEY hKey,	// дескриптор открытого ключа
    LPCTSTR lpSubKey,	// адрес имени открываемого подключа
    PHKEY phkResult 	// адрес дескриптора открытого ключа
   );
Параметры:

hKey Идентифицирует открытый в текущий момент ключ или один из следующих предопределенных значений дескрипторов:

HKEY_CLASSES_ROOT
HKEY_CURRENT_USER
HKEY_LOCAL_MACHINE
HKEY_USERS
HKEY_CURRENT_CONFIG

Ключ, открытый функцией RegOpenKey, является подключем ключа, указанного в hKey.
lpSubKey Адрес нульзаканчивающейся строки, содержащей имя ключа на открытие. Этот ключ должен быть подключем ключа, указанного в параметре hKey. Если этот параметр равен NULL или адрес указывает на пустую строку, функция возвращает тот-же дескриптор, который ей был дан в параметре hKey.
phkResult Адрес переменной, в которую возвращается дескриптор открытого ключа.

Возвращаемые значения:

Если функция успешна, возвращается значение ERROR_SUCCESS.

При ошибке, возвращаемое значение – это код ошибки, объявленный в WINERROR.H. Вы можете использовать функцию FormatMessage с флагом FORMAT_MESSAGE_FROM_SYSTEM для получения общего описания ошибки.

Замечания:

Функция RegOpenKey использует маску из доступа безопасности по умолчанию для открытия ключа. Если открываемый ключ требует другую маску, функция завершается ошибкой и возвращает ERROR_ACCESS_DENIED. Приложение может использовать функцию RegOpenKeyEx для указания маски доступа в такой ситуации.

В отличии от RegCreateKey, функция RegOpenKey не создает указанный ключ если такой ключ не существует в базе данных.

Смотрите также:

RegCloseKey, RegCreateKey, RegCreateKeyEx, RegDeleteKey, RegOpenKeyEx



Hosted by uCoz