Fonction EnumDesktopWindows (winuser.h)
Énumère toutes les fenêtres de niveau supérieur associées au bureau spécifié. Il transmet le handle à chaque fenêtre, à son tour, à une fonction de rappel définie par l’application.
Syntaxe
BOOL EnumDesktopWindows(
[in, optional] HDESK hDesktop,
[in] WNDENUMPROC lpfn,
[in] LPARAM lParam
);
Paramètres
[in, optional] hDesktop
Handle du bureau dont les fenêtres de niveau supérieur doivent être énumérées. Ce handle est retourné par la fonction CreateDesktop, GetThreadDesktop, OpenDesktop ou OpenInputDesktop et doit disposer du droit d’accès DESKTOP_READOBJECTS . Pour plus d’informations, consultez Sécurité du bureau et droits d’accès.
Si ce paramètre a la valeur NULL, le bureau actuel est utilisé.
[in] lpfn
Pointeur vers une fonction de rappel EnumWindowsProc définie par l’application.
[in] lParam
Valeur définie par l’application à passer à la fonction de rappel.
Valeur retournée
Si la fonction échoue ou ne peut pas effectuer l’énumération, la valeur de retour est zéro.
Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Vous devez vous assurer que la fonction de rappel définit SetLastError en cas d’échec.
Windows Server 2003 et Windows XP/2000 : S’il n’existe aucune fenêtre sur le bureau, GetLastError retourne ERROR_INVALID_HANDLE.
Remarques
La fonction EnumDesktopWindows appelle à plusieurs reprises la fonction de rappel lpfn jusqu’à ce que la dernière fenêtre de niveau supérieur soit énumérée ou que la fonction de rappel retourne FALSE.
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-windowstation-l1-1-0 (introduit dans Windows 8) |