CloseDesktop 関数 (winuser.h)
開いているハンドルをデスクトップ オブジェクトに閉じます。
構文
BOOL CloseDesktop(
[in] HDESK hDesktop
);
パラメーター
[in] hDesktop
閉じるデスクトップへのハンドル。 これは、 CreateDesktop、OpenDesktop、または OpenInputDesktop 関数によって返されるハンドル です 。 GetThreadDesktop 関数によって返されるハンドルを指定しないでください。
戻り値
関数が成功すると、戻り値は 0 以外になります。
関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。
解説
CloseDesktop 関数は、呼び出し元プロセス内のスレッドが指定されたデスクトップ ハンドルを使用している場合、またはハンドルが呼び出し元プロセスの初期デスクトップを参照している場合に失敗します。
要件
| サポートされている最小のクライアント | 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 で導入) |