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 で導入) |