Partager via


Fonction EnumWindows (winuser.h)

É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)

Voir aussi

Conceptuel

EnumChildWindows

EnumWindowsProc

GetWindow

Référence

Windows