Voltar à lista
Windows Win32Registroadvapi32.dll

RegCreateKeyExW

Cria uma nova chave do Registro (ou abre uma existente).

Descrição

Se a chave já existir, comporta-se como RegOpenKeyExW — o parâmetro `lpdwDisposition` informa qual dos dois casos ocorreu.

Header: winreg.hDLL: advapi32.dllNative API: NtCreateKey

Assinatura

LSTATUS RegCreateKeyExW(
    HKEY hKey,
    LPCWSTR lpSubKey,
    DWORD Reserved,
    LPWSTR lpClass,
    DWORD dwOptions,
    REGSAM samDesired,
    LPSECURITY_ATTRIBUTES lpSecurityAttributes,
    PHKEY phkResult,
    LPDWORD lpdwDisposition
);

Parâmetros

ParâmetroTipoDescrição
hKeyHKEYChave pai.
lpSubKeyLPCWSTRCaminho da subchave a criar/abrir.
ReservedDWORDDeve ser 0.
lpClassLPWSTRClasse da chave (raramente usada), ou NULL.
dwOptionsDWORDREG_OPTION_NON_VOLATILE, REG_OPTION_VOLATILE.
samDesiredREGSAMDireitos de acesso desejados.
lpSecurityAttributesLPSECURITY_ATTRIBUTESAtributos de segurança, ou NULL.
phkResultPHKEYRecebe o handle da chave.
lpdwDispositionLPDWORDRecebe REG_CREATED_NEW_KEY ou REG_OPENED_EXISTING_KEY.

Valor de retorno

ERROR_SUCCESS em sucesso; um código de erro do Windows caso contrário.

Códigos de erro (GetLastError)

ERROR_ACCESS_DENIED(5)
Acesso negado.
ERROR_INVALID_PARAMETER(87)
Parâmetro incorreto.

Relacionadas

Mesma categoria

RegCloseKeyRegDeleteKeyWRegDeleteValueWRegEnumKeyExWRegEnumValueWRegFlushKeyRegGetValueWRegLoadKeyW