На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

RegOpenKeyEx



The RegOpenKeyEx function opens the specified key.

LONG RegOpenKeyEx(

HKEY hKey, // handle of open key
LPCTSTR lpSubKey, // address of name of subkey to open
DWORD ulOptions, // reserved
REGSAM samDesired, // security access mask
PHKEY phkResult // address of handle of open key
);


Parameters

hKey

Identifies a currently open key or any of the following predefined reserved handle values:

HKEY_CLASSES_ROOT
HKEY_CURRENT_USER
HKEY_LOCAL_MACHINE
HKEY_USERS

lpSubKey

Points to a null-terminated string containing the name of the subkey to open. If this parameter is NULL or a pointer to an empty string, the function will open a new handle of the key identified by the hKey parameter. In this case, the function will not close the handles previously opened.

ulOptions

Reserved; must be zero.

samDesired

Specifies an access mask that describes the desired security access for the new key. This parameter can be a combination of the following values:

Value Meaning
KEY_ALL_ACCESS Combination of KEY_QUERY_VALUE, KEY_ENUMERATE_SUB_KEYS, KEY_NOTIFY, KEY_CREATE_SUB_KEY, KEY_CREATE_LINK, and KEY_SET_VALUE access.
KEY_CREATE_LINK Permission to create a symbolic link.
KEY_CREATE_SUB_KEY Permission to create subkeys.
KEY_ENUMERATE_SUB_KEYS Permission to enumerate subkeys.
KEY_EXECUTE Permission for read access.
KEY_NOTIFY Permission for change notification.
KEY_QUERY_VALUE Permission to query subkey data.
KEY_READ Combination of KEY_QUERY_VALUE, KEY_ENUMERATE_SUB_KEYS, and KEY_NOTIFY access.
KEY_SET_VALUE Permission to set subkey data.
KEY_WRITE Combination of KEY_SET_VALUE and KEY_CREATE_SUB_KEY access.


phkResult

Points to a variable that receives the handle of the opened key.



Return Values

If the function succeeds, the return value is ERROR_SUCCESS.
If the function fails, the return value is a nonzero error code defined in WINERROR.H. You can use the FormatMessage function with the FORMAT_MESSAGE_FROM_SYSTEM flag to get a generic description of the error.

Remarks

Unlike the RegCreateKeyEx function, the RegOpenKeyEx function does not create the specified key if the key does not exist in the registry.

See Also

RegCloseKey, RegCreateKeyEx, RegDeleteKey, RegOpenKey


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

RegOpenKeyEx



Функция RegOpenKeyEx открывает определенный ключ.

ДОЛГО (ДЛИНОЙ) RegOpenKeyEx(

HKEY hKey, // РУЧКА открытого ключа LPCTSTR lpSubKey, // адреса имени подключа, чтобы открывать DWORD ulOptions, // зарезервировавшее REGSAM samDesired, // маска доступа адреса безопасности PHKEY phkResult // ручки открытого ключа
);


Параметры

hKey

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

HKEY_CLASSES_ROOT HKEY_CURRENT_USER HKEY_LOCAL_MACHINE HKEY_USERS

lpSubKey

Точки на недействительный расторгнутую строку, содержащие имя подключа, чтобы открываться. Если этот параметр является НЕДЕЙСТВИТЕЛЬНЫМ или указателем в пустую строку, функция откроет новую ручку ключа идентифицированного параметром hKey. В этом случае, функция не закроет прежде открытые ручки.

ulOptions

Зарезервированное; должно - нулевым.

samDesired

Определяет маску доступа, которая описывает желаемый доступ безопасности для нового ключа. Этот параметр может быть комбинацией следующего величин:

Значение Величины
Комбинация KEY_ALL_ACCESS KEY_QUERY_VALUE, KEY_ENUMERATE_SUB_KEYS, KEY_NOTIFY, KEY_CREATE_SUB_KEY, KEY_CREATE_LINK, и KEY_SET_VALUE имеет доступ к.
Разрешение KEY_CREATE_LINK должно создать символическую связь.
Разрешение KEY_CREATE_SUB_KEY должно создать подключи.
Разрешение KEY_ENUMERATE_SUB_KEYS должно перечислить подключи.
Разрешение KEY_EXECUTE для доступа чтения.
Разрешение KEY_NOTIFY для уведомления изменения.
Разрешение KEY_QUERY_VALUE в данные подключа запроса.
Комбинация KEY_READ KEY_QUERY_VALUE, KEY_ENUMERATE_SUB_KEYS, и KEY_NOTIFY имеет доступ к.
Разрешение KEY_SET_VALUE должно устанавливать данные подключа.
Комбинация KEY_WRITE KEY_SET_VALUE и KEY_CREATE_SUB_KEY имеет доступ к.


phkResult

Точки на переменную, которые получают ручку открытой клавиши.



Обратные Величины

Если функция добивается успеха, обратная величина - ERROR_SUCCESS.
Если функция терпит неудачу, обратная величина является ненулевым кодом ошибки определенным в WINERROR.H. Вы можете использовать функцию FormatMessage с флагом FORMAT_MESSAGE_FROM_SYSTEM, чтобы получать общее описание ошибки.

Замечания

В отличие от функции RegCreateKeyEx, функция RegOpenKeyEx не создает определенную клавишу если клавиша не существует в регистрации.

Смотри Также

RegCloseKey, RegCreateKeyEx, RegDeleteKey, RegOpenKey


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz