Voltar à lista
Windows Win32Registroadvapi32.dll

RegEnumValueW

Enumera os valores nomeados de uma chave do Registro, um por índice.

Descrição

Análogo a RegEnumKeyExW, mas para os valores dentro de uma chave em vez de suas subchaves.

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

Assinatura

LSTATUS RegEnumValueW(
    HKEY hKey,
    DWORD dwIndex,
    LPWSTR lpValueName,
    LPDWORD lpcchValueName,
    LPDWORD lpReserved,
    LPDWORD lpType,
    LPBYTE lpData,
    LPDWORD lpcbData
);

Parâmetros

ParâmetroTipoDescrição
hKeyHKEYHandle da chave, aberto com KEY_QUERY_VALUE.
dwIndexDWORDÍndice do valor a enumerar.
lpValueNameLPWSTRRecebe o nome do valor.
lpcchValueNameLPDWORDTamanho de `lpValueName`; atualizado com o tamanho real.
lpReservedLPDWORDDeve ser NULL.
lpTypeLPDWORDSe não for NULL, recebe o tipo do valor.
lpDataLPBYTERecebe o dado do valor, ou NULL para ignorar.
lpcbDataLPDWORDTamanho de `lpData`.

Valor de retorno

ERROR_SUCCESS em sucesso; ERROR_NO_MORE_ITEMS ao final da enumeração; outro código de erro caso contrário.

Códigos de erro (GetLastError)

ERROR_NO_MORE_ITEMS(259)
Não há mais itens disponíveis.
ERROR_MORE_DATA(234)
Há mais dados disponíveis do que o buffer comporta.

Relacionadas

Mesma categoria

RegCloseKeyRegCreateKeyExWRegDeleteKeyWRegDeleteValueWRegEnumKeyExWRegFlushKeyRegGetValueWRegLoadKeyW