Expand Minimize

EnumThreadWindows function

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 WINAPI EnumThreadWindows(
  _In_  DWORD dwThreadId,
  _In_  WNDENUMPROC lpfn,
  _In_  LPARAM lParam
);

Parameters

dwThreadId [in]

Type: DWORD

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

lpfn [in]

Type: WNDENUMPROC

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

lParam [in]

Type: LPARAM

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

Return value

Type:

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

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Winuser.h (include Windows.h)

Library

User32.lib

DLL

User32.dll

See also

Reference
EnumChildWindows
EnumThreadWndProc
EnumWindows
Conceptual
Windows

 

 

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.