Voltar à lista
Windows Win32Registroadvapi32.dll

RegGetValueW

Lê um valor do Registro em um único passo, combinando abertura de subchave, leitura e conversão de tipo opcional.

Descrição

API de conveniência mais moderna que RegQueryValueExW, evitando abrir uma chave separadamente apenas para ler um único valor.

Header: winreg.hDLL: advapi32.dll

Assinatura

LSTATUS RegGetValueW(
    HKEY hkey,
    LPCWSTR lpSubKey,
    LPCWSTR lpValue,
    DWORD dwFlags,
    LPDWORD pdwType,
    PVOID pvData,
    LPDWORD pcbData
);

Parâmetros

ParâmetroTipoDescrição
hkeyHKEYChave base.
lpSubKeyLPCWSTRSubchave relativa a `hkey`, ou NULL para usar `hkey` diretamente.
lpValueLPCWSTRNome do valor a ler.
dwFlagsDWORDRRF_RT_ANY, RRF_RT_REG_SZ, RRF_RT_REG_DWORD, etc. — restringe/converte tipos aceitos.
pdwTypeLPDWORDSe não for NULL, recebe o tipo do valor.
pvDataPVOIDBuffer de destino para o dado.
pcbDataLPDWORDTamanho de `pvData`; atualizado com o tamanho real.

Valor de retorno

ERROR_SUCCESS em sucesso; um código de erro do Windows 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

RegCloseKeyRegCreateKeyExWRegDeleteKeyWRegDeleteValueWRegEnumKeyExWRegEnumValueWRegFlushKeyRegLoadKeyW