Share via


CloseDesktop 函式 (winuser.h)

關閉桌面物件的開啟控制碼。

語法

BOOL CloseDesktop(
  [in] HDESK hDesktop
);

參數

[in] hDesktop

要關閉之桌面的控制碼。 這可以是CreateDesktop、OpenDesktopOpenInputDesktop函式所傳回的控制碼。 請勿指定 GetThreadDesktop 函式所傳回的控制碼。

傳回值

如果函式成功,則傳回非零的值。

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

備註

如果呼叫進程中的任何執行緒使用指定的桌面控制碼,或控制碼參考呼叫進程的初始桌面, CloseDesktop 函式將會失敗。

規格需求

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

另請參閱

CreateDesktop

Desktops

OpenDesktop

OpenInputDesktop

視窗月臺和桌面函式