Поделиться через


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

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

Синтаксис

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)

См. также раздел

Настольные системы

GetCurrentThreadId

GetProcessWindowStation

GetUserObjectInformation

GetUserObjectSecurity

SetProcessWindowStation

SetThreadDesktop

SetUserObjectInformation

SetUserObjectSecurity

Функции оконных станций и настольных компьютеров