GetGUIThreadInfo

GetGUIThreadInfo

지정한 GUI스레드 또는 활성윈도우의 정보를 반환한다.

Syntax

BOOL WINAPI GetGUIThreadInfo(  _In_    DWORD           idThread,  _Inout_ LPGUITHREADINFO lpgui );

Parameters

idThread [in]

Type: DWORD

정보를 확인할 스레드의 ID값으로 GetWindowThreadProcessId 함수로 확인이 가능합니다.

값을 NULL로 지정하는 경우 foreground윈도우에 대한 정보를 반환합니다.

lpgui [in, out]

Type: LPGUITHREADINFO

GUI스레드 정보값(리턴값)이 저장될 GUITHREDINFO의 포인터값입니다. 해당 함수 호출전에 반드시 구조체 멤버인 cbSize에 해당 구조체의 크기( sizeof(GUITHREADINFO) )가 먼저 설정되어 있어야 합니다.

Return value

성공시 TRUE, 실패시 FALSE이며 자세한 오류정보는 GetLastError를 통해 확인가능합니다.

Remarks

정보를 확인하려는 활성윈도우가 함수가 호출되는 프로세스의 소유가 아닌 경우에도 정상적으로 동작하지만

지정한 스레드ID값에 해당하는 스레드가 없거나 입력queue를 가지고 있는 경우에는 정보확인에 실패합니다.

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