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

LONG RegCreateKey(
    HKEY hKey,		// дескриптор открытого окна
    LPCTSTR lpSubKey,	// адрес имени открываемого подключа 
    PHKEY phkResult	// адрес буфера для открытого дескриптора 
   );

Параметры:

hKey	Идентифицирует уже открытый ключ или один из предопределенных дескрипторов: HKEY_CLASSES_ROOT HKEY_CURRENT_USER HKEY_LOCAL_MACHINE HKEY_USERS HKEY_CURRENT_CONFIG Ключ, открытый или созданный функцией RegCreateKey, являются подключами ключа, указанного в параметре hKey.
lpSubKey	Адрес нульзаканчивающейся строки, определяющей имя подключа, который эта функция создает или открывает. Указанный подключ должен быть подключем ключа, указанного в параметре hKey. Если hKey – это один из предопределенных ключей, то lpSubKey должен быт NULL. В этом случае, возвращаемый дескриптор в phkResult, это тот-же дескриптор, который передается функции в hKey.
phkResult	дрес переменной, куда будет возвращен дескриптор,открываемого или создаваемого ключа.

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

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

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

Замечания:

Приложение может использовать функция RegCreateKey для создания нескольких ключей одновременно. Например, приложение может создать подключ четырех уровней вглубь, если они указаны в строке lpSubKey в таком виде: subkey1\subkey2\subkey3\subkey4

Ключ, который указывается в параметре hKey, должен быть открыть с доступом KEY_CREATE_SUB_KEY (доступ KEY_WRITE вкючает в себя и доступ KEY_CREATE_SUB_KEY).

Если lpSubKey ссылается на пустую строку, функция открывает и потом возвращает обратно ключ, указанный в параметре hKey.

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

RegCloseKey, RegCreateKeyEx, RegDeleteKey, RegOpenKey, RegOpenKeyEx, RegSetValue