Voltar à lista
Windows Win32Registroadvapi32.dll

RegOpenKeyExW

Abre uma chave do Registro do Windows, retornando um handle para operações subsequentes.

Descrição

O Registro é um banco de dados hierárquico de configuração sem equivalente direto no Linux tradicional (onde configuração costuma viver em arquivos texto sob /etc, /proc/sys ou ~/.config) — HKEY_LOCAL_MACHINE, HKEY_CURRENT_USER, etc. são as 'raízes' dessa hierarquia.

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

Assinatura

LSTATUS RegOpenKeyExW(
    HKEY hKey,
    LPCWSTR lpSubKey,
    DWORD ulOptions,
    REGSAM samDesired,
    PHKEY phkResult
);

Parâmetros

ParâmetroTipoDescrição
hKeyHKEYChave pai já aberta, ou uma das raízes predefinidas (HKEY_LOCAL_MACHINE, HKEY_CURRENT_USER, ...).
lpSubKeyLPCWSTRCaminho da subchave a abrir, relativo a `hKey`.
ulOptionsDWORDOpções, geralmente 0.
samDesiredREGSAMDireitos de acesso desejados: KEY_READ, KEY_WRITE, KEY_ALL_ACCESS.
phkResultPHKEYRecebe o handle da chave aberta.

Valor de retorno

ERROR_SUCCESS (0) em sucesso; um código de erro do Windows caso contrário (retornado diretamente, não via GetLastError).

Códigos de erro (GetLastError)

ERROR_FILE_NOT_FOUND(2)
O sistema não conseguiu encontrar o arquivo especificado.
ERROR_ACCESS_DENIED(5)
Acesso negado.

Relacionadas

Mesma categoria

RegCloseKeyRegCreateKeyExWRegDeleteKeyWRegDeleteValueWRegEnumKeyExWRegEnumValueWRegFlushKeyRegGetValueW