Função EnumWindows (winuser.h)

Artigo
03/04/2024

Enumera todas as janelas de nível superior na tela passando o identificador para cada janela, por sua vez, para uma função de retorno de chamada definida pelo aplicativo. EnumWindows continua até que a última janela de nível superior seja enumerada ou a função de retorno de chamada retorne FALSE.

Sintaxe

BOOL EnumWindows(
  [in] WNDENUMPROC lpEnumFunc,
  [in] LPARAM      lParam
);

Parâmetros

[in] lpEnumFunc

Tipo: WNDENUMPROC

Um ponteiro para uma função de retorno de chamada definida pelo aplicativo. Para obter mais informações, consulte EnumWindowsProc.

[in] lParam

Tipo: LPARAM

Um valor definido pelo aplicativo a ser passado para a função de retorno de chamada.

Retornar valor

Tipo: BOOL

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Se EnumWindowsProc retornar zero, o valor retornado também será zero. Nesse caso, a função de retorno de chamada deve chamar SetLastError para obter um código de erro significativo a ser retornado ao chamador de EnumWindows.

Comentários

A função EnumWindows não enumera janelas filho, com exceção de algumas janelas de nível superior pertencentes ao sistema que têm o estilo WS_CHILD .

Essa função é mais confiável do que chamar a função GetWindow em um loop. Um aplicativo que chama GetWindow para executar essa tarefa corre o risco de ser capturado em um loop infinito ou referenciar um identificador para uma janela que foi destruída.

Nota Por Windows 8 e posteriores, enumWindows enumera apenas janelas de nível superior de aplicativos da área de trabalho.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winuser.h (inclua Windows.h)
Biblioteca	User32.lib
DLL	User32.dll
Conjunto de APIs	ext-ms-win-ntuser-window-l1-1-0 (introduzido no Windows 8)