GetThreadDesktop 函式 (winuser.h)

擷取指派給指定線程之桌面的句柄。

語法

HDESK GetThreadDesktop(
  [in] DWORD dwThreadId
);

[in] dwThreadId

執行緒識別碼。 GetCurrentThreadId 和 CreateProcess 函式會傳回線程標識碼。

如果函式成功，則傳回值是與指定線程相關聯的桌面句柄。您不需要呼叫 CloseDesktop 函式來關閉傳回的句柄。

如果函式失敗，則傳回值為 NULL。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

系統會在建立該線程時，將桌面與線程產生關聯。線程可以使用 SetThreadDesktop 函式來變更其桌面。與線程相關聯的桌面必須位於與線程進程相關聯的視窗站臺上。

服務應用程式是使用相關聯的視窗月臺和桌面所建立，因此不需要呼叫USER或 GDI 函式，將服務連線到視窗月臺和桌面。

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	winuser.h (包括 Windows.h)
程式庫	User32.lib
Dll	User32.dll
API 集合	ext-ms-win-ntuser-windowstation-l1-1-0 (於 Windows 8)