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


CRegKey::Open

Вызовите этот метод, чтобы открыть указанный ключ и set m_hKey на маркер этого ключа.

LONG Open( 
   HKEY hKeyParent, 
   LPCTSTR lpszKeyName, 
   REGSAM samDesired = KEY_READ | KEY_WRITE 
) throw( );

Параметры

  • hKeyParent
    Маркер открытого ключа.

  • lpszKeyName
    Указывает имя открытого ключа, который требуется создать. Это имя должно быть hKeyParent подразделом.

  • samDesired
    Доступ безопасности для ключа. Значение по умолчанию KEY_ALL_ACCESS. Список возможных значений и описаний см. в разделе RegCreateKeyEx в Windows SDK.

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

Если успешно, передачи ERROR_SUCCESS; в противном случае ненулевое значение ошибки, указанное в WINERROR.H.

Заметки

Если параметр lpszKeyName NULL или указывает на пустой строке, то Открыть открывает новый дескриптор ключа указанного hKeyParent, но не закрывает открытый дескриптор не ранее.

В отличие от CRegKey::Create, Открыть не создает заданным ключом, если она не существует.

Требования

Header: atlbase.h

См. также

Ссылки

CRegKey Class

CRegKey::Close