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
ヘッダー	winuser.h (Windows.h を含む)
Library	User32.lib
[DLL]	User32.dll
API セット	ext-ms-win-ntuser-windowstation-l1-1-0 (Windows 8 で導入)