Edit

EnumThreadWindows function (winuser.h)

  • Article

Enumerates all nonchild windows associated with a thread by passing the handle to each window, in turn, to an application-defined callback function. EnumThreadWindows continues until the last window is enumerated or the callback function returns FALSE. To enumerate child windows of a particular window, use the EnumChildWindows function.

Syntax

BOOL EnumThreadWindows(
  [in] DWORD       dwThreadId,
  [in] WNDENUMPROC lpfn,
  [in] LPARAM      lParam
);

Parameters

[in] dwThreadId

Type: DWORD

The identifier of the thread whose windows are to be enumerated.

[in] lpfn

Type: WNDENUMPROC

A pointer to an application-defined callback function. For more information, see EnumThreadWndProc.

[in] lParam

Type: LPARAM

An application-defined value to be passed to the callback function.

Return value

Type: BOOL

If the callback function returns TRUE for all windows in the thread specified by dwThreadId, the return value is TRUE. If the callback function returns FALSE on any enumerated window, or if there are no windows found in the thread specified by dwThreadId, the return value is FALSE.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header winuser.h (include Windows.h)
Library User32.lib
DLL User32.dll
API set ext-ms-win-ntuser-window-l1-1-0 (introduced in Windows 8)

See also

Conceptual

EnumChildWindows

EnumThreadWndProc

EnumWindows

Reference

Windows