Voltar à lista
Windows Win32Registroadvapi32.dll

RegQueryValueExW

Lê o valor e o tipo de um valor nomeado dentro de uma chave do Registro.

Descrição

Valores do Registro são tipados (REG_SZ, REG_DWORD, REG_BINARY, REG_MULTI_SZ, etc.), diferente de arquivos de configuração texto simples.

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

Assinatura

LSTATUS RegQueryValueExW(
    HKEY hKey,
    LPCWSTR lpValueName,
    LPDWORD lpReserved,
    LPDWORD lpType,
    LPBYTE lpData,
    LPDWORD lpcbData
);

Parâmetros

ParâmetroTipoDescrição
hKeyHKEYHandle da chave.
lpValueNameLPCWSTRNome do valor a ler, ou NULL/vazio para o valor padrão da chave.
lpReservedLPDWORDDeve ser NULL.
lpTypeLPDWORDSe não for NULL, recebe o tipo do valor (REG_SZ, REG_DWORD, ...).
lpDataLPBYTEBuffer de destino para o dado.
lpcbDataLPDWORDTamanho de `lpData`; atualizado com o tamanho real do dado.

Valor de retorno

ERROR_SUCCESS em sucesso; ERROR_MORE_DATA se o buffer for pequeno demais; outro código de erro caso contrário.

Códigos de erro (GetLastError)

ERROR_FILE_NOT_FOUND(2)
O sistema não conseguiu encontrar o arquivo especificado.
ERROR_MORE_DATA(234)
Há mais dados disponíveis do que o buffer comporta.

Relacionadas

Mesma categoria

RegCloseKeyRegCreateKeyExWRegDeleteKeyWRegDeleteValueWRegEnumKeyExWRegEnumValueWRegFlushKeyRegGetValueW