Fonction EnumWindows (winuser.h)

Article
03/04/2024

Énumère toutes les fenêtres de niveau supérieur de l’écran en passant le handle à chaque fenêtre, à son tour, à une fonction de rappel définie par l’application. EnumWindows continue jusqu’à ce que la dernière fenêtre de niveau supérieur soit énumérée ou que la fonction de rappel retourne FALSE.

Syntaxe

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

Paramètres

[in] lpEnumFunc

Type : WNDENUMPROC

Pointeur vers une fonction de rappel définie par l’application. Pour plus d’informations, consultez EnumWindowsProc.

[in] lParam

Type : LPARAM

Valeur définie par l’application à passer à la fonction de rappel.

Valeur retournée

Type : BOOL

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Si EnumWindowsProc retourne zéro, la valeur de retour est également égale à zéro. Dans ce cas, la fonction de rappel doit appeler SetLastError pour obtenir un code d’erreur significatif à retourner à l’appelant d’EnumWindows.

Remarques

La fonction EnumWindows n’énumère pas les fenêtres enfants, à l’exception de quelques fenêtres de niveau supérieur appartenant au système qui ont le style WS_CHILD .

Cette fonction est plus fiable que l’appel de la fonction GetWindow dans une boucle. Une application qui appelle GetWindow pour effectuer cette tâche risque d’être interceptée dans une boucle infinie ou de référencer un handle à une fenêtre qui a été détruite.

Note Pour Windows 8 et versions ultérieures, EnumWindows énumère uniquement les fenêtres de niveau supérieur des applications de bureau.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winuser.h (inclure Windows.h)
Bibliothèque	User32.lib
DLL	User32.dll
Ensemble d’API	ext-ms-win-ntuser-window-l1-1-0 (introduit dans Windows 8)