CRegKey::Create

Статья
06/09/2015

Вызывайте этот метод для создания заданным ключом, если она не существует, как подраздел hKeyParent.

LONG Create( 
   HKEY hKeyParent, 
   LPCTSTR lpszKeyName, 
   LPTSTR lpszClass = REG_NONE, 
   DWORD dwOptions = REG_OPTION_NON_VOLATILE, 
   REGSAM samDesired = KEY_READ | KEY_WRITE, 
   LPSECURITY_ATTRIBUTES lpSecAttr = NULL, 
   LPDWORD lpdwDisposition = NULL  
) throw( );

Параметры

hKeyParent
Маркер открытого ключа.
lpszKeyName
Указывает имя открытого ключа, который требуется создать. Это имя должно быть hKeyParent подразделом.
lpszClass
Определяет класс, открытого ключа, который требуется создать. Значение по умолчанию REG_NONE.
dwOptions
Параметры для ключа. Значение по умолчанию REG_OPTION_NON_VOLATILE. Список возможных значений и описаний см. в разделе RegCreateKeyEx в Windows SDK.
samDesired
Доступ безопасности для ключа. Значение по умолчанию KEY_READ | KEY_WRITE. Список возможных значений и описаний см. в разделе RegCreateKeyEx.
lpSecAttr
Указатель на структуру SECURITY_ATTRIBUTES, указывающее, является ли дескриптор ключа может наследоваться процессом дочернего элемента. По умолчанию этот параметр имеет значение null (означать маркер не может быть унаследован.
lpdwDisposition
[out] Если REG_CREATED_NEW_KEY, отличных от NULL, возвращает или (если был создан ключ не существовал и) или REG_OPENED_EXISTING_KEY (если ключ существовал и открыт).

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

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

Заметки

Создать задает участника m_hKey на маркер этого ключа.

Требования

Header: atlbase.h

См. также

Ссылки

CRegKey Class

CRegKey::Open

CRegKey::Close

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