GetThreadDesktop 1MWBFQ1

The GetThreadDesktop function returns a handle to the desktop associated with a specified thread.

HDESK GetThreadDesktop(

DWORD dwThreadId	// thread identifier
);

Parameters

dwThreadId

Identifies the thread for which to return the desktop handle. The GetCurrentThreadId1SHENB6 and CreateProcess5FBJ_XX functions return thread identifiers.

Return Values

If the function succeeds, the return value is the handle of the desktop associated with the specified thread.

Remarks

The system associates a desktop with a thread when that thread is created. A thread can use the SetThreadDesktop1N0X8YO function to change its desktop. The desktop associated with a thread must be on the window station associated with the thread s process.

The calling process can use the returned handle in calls to the GetUserObjectInformation, GetUserObjectSecurity, SetUserObjectInformation, and SetUserObjectSecurity functions.

Windows 95: Windows 95 does not support multiple desktops, so GetThreadDesktop always returns the same value.