Função EnumWindows (winuser.h)
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.
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) |
Confira também
Conceitual
Referência