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

関連項目

CreateDesktop

デスクトップ

OpenDesktop

OpenInputDesktop

ウィンドウ ステーションとデスクトップ関数