Skip to content

Latest commit

 

History

History
82 lines (67 loc) · 2.36 KB

nf-winuser-isguithread.md

File metadata and controls

82 lines (67 loc) · 2.36 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:winuser.IsGUIThread
IsGUIThread function (winuser.h)
Determines whether the calling thread is already a GUI thread. It can also optionally convert the thread to a GUI thread.
IsGUIThread
IsGUIThread function [Windows and Messages]
_win32_IsGUIThread
_win32_isguithread_cpp
winmsg.isguithread
winui._win32_isguithread
winuser/IsGUIThread
winmsg\isguithread.htm
winmsg
VS|winui|~\winui\windowsuserinterface\windowing\windows\windowreference\windowfunctions\isguithread.htm
12/05/2018
IsGUIThread, IsGUIThread function [Windows and Messages], _win32_IsGUIThread, _win32_isguithread_cpp, winmsg.isguithread, winui._win32_isguithread, winuser/IsGUIThread
winuser.h
Windows.h
Windows
Windows XP [desktop apps only]
Windows Server 2003 [desktop apps only]
User32.lib
User32.dll
Windows
19H1
IsGUIThread
winuser/IsGUIThread
c++
APIRef
kbSyntax
DllExport
User32.dll
API-MS-Win-RTCore-NTUser-Window-l1-1-0.dll
minuser.dll
Ext-MS-Win-RTCore-NTUser-Window-Ext-l1-1-0.dll
IsGUIThread

IsGUIThread function

-description

Determines whether the calling thread is already a GUI thread. It can also optionally convert the thread to a GUI thread.

-parameters

-param bConvert [in]

Type: BOOL

If TRUE and the thread is not a GUI thread, convert the thread to a GUI thread.

-returns

Type: BOOL

The function returns a nonzero value in the following situations:

  • If the calling thread is already a GUI thread.
  • If bConvert is TRUE and the function successfully converts the thread to a GUI thread.
Otherwise, the function returns zero.

If bConvert is TRUE and the function cannot successfully convert the thread to a GUI thread, IsGUIThread returns ERROR_NOT_ENOUGH_MEMORY.

-see-also

Windows Overview