Функция GetThreadDesktop (winuser.h)

Статья
08/27/2023

Извлекает дескриптор на рабочий стол, назначенный указанному потоку.

Синтаксис

HDESK GetThreadDesktop(
  [in] DWORD dwThreadId
);

Параметры

[in] dwThreadId

Идентификатор потока. Функции GetCurrentThreadId и CreateProcess возвращают идентификаторы потоков.

Возвращаемое значение

Если функция выполняется успешно, возвращаемое значение будет дескриптором рабочего стола, связанного с указанным потоком. Чтобы закрыть возвращенный дескриптор, вызывать функцию CloseDesktop не нужно.

Если функция завершается сбоем, возвращается значение NULL. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Система связывает рабочий стол с потоком при создании этого потока. Поток может использовать функцию SetThreadDesktop для изменения рабочего стола. Рабочий стол, связанный с потоком, должен находиться на оконной станции, связанной с процессом потока.

Вызывающий процесс может использовать возвращенный дескриптор в вызовах функций GetUserObjectInformation, GetUserObjectSecurity, SetUserObjectInformation и SetUserObjectSecurity .

Приложение службы создается со связанной оконной станцией и рабочим столом, поэтому нет необходимости вызывать функцию USER или GDI для подключения службы к оконной станции и рабочему столу.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winuser.h (включая Windows.h)
Библиотека	User32.lib
DLL	User32.dll
Набор API	ext-ms-win-ntuser-windowstation-l1-1-0 (представлено в Windows 8)