Voltar à lista
Windows Win32Registroadvapi32.dll

RegEnumKeyExW

Enumera as subchaves de uma chave do Registro, uma por índice.

Descrição

Chamada repetidamente com índices crescentes (0, 1, 2, ...) até retornar ERROR_NO_MORE_ITEMS, análogo a ler entradas de diretório com `getdents64` no Linux.

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

Assinatura

LSTATUS RegEnumKeyExW(
    HKEY hKey,
    DWORD dwIndex,
    LPWSTR lpName,
    LPDWORD lpcchName,
    LPDWORD lpReserved,
    LPWSTR lpClass,
    LPDWORD lpcchClass,
    PFILETIME lpftLastWriteTime
);

Parâmetros

ParâmetroTipoDescrição
hKeyHKEYHandle da chave, aberto com KEY_ENUMERATE_SUB_KEYS.
dwIndexDWORDÍndice da subchave a enumerar.
lpNameLPWSTRRecebe o nome da subchave.
lpcchNameLPDWORDTamanho de `lpName`; atualizado com o tamanho real.
lpReservedLPDWORDDeve ser NULL.
lpClassLPWSTRRecebe a classe da subchave, ou NULL para ignorar.
lpcchClassLPDWORDTamanho de `lpClass`.
lpftLastWriteTimePFILETIMESe não for NULL, recebe o timestamp da última modificação.

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

RegCloseKeyRegCreateKeyExWRegDeleteKeyWRegDeleteValueWRegEnumValueWRegFlushKeyRegGetValueWRegLoadKeyW