isGUIThread 函式 (winuser.h)

  • 發行項

判斷呼叫線程是否已經是 GUI 線程。 它也可以選擇性地將線程轉換成 GUI 線程。

語法

BOOL IsGUIThread(
  [in] BOOL bConvert
);

參數

[in] bConvert

類型： BOOL

如果 TRUE 且線程不是 GUI 線程，請將線程轉換成 GUI 線程。

傳回值

類型： BOOL

在下列情況下，函式會傳回非零值：

  • 如果呼叫線程已經是 GUI 線程。
  • 如果 bConvert 為 TRUE ，且函式成功將線程轉換為 GUI 線程。
否則，此函式會傳回零。

如果 bConvert 為 TRUE ，而且函式無法成功將線程轉換為 GUI 線程， IsGUIThread 會 傳回ERROR_NOT_ENOUGH_MEMORY。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 winuser.h (包含 Windows.h)
程式庫 User32.lib
Dll User32.dll

另請參閱

Windows 概觀