EmptyClipboard 函式 (winuser.h)

發行項
03/04/2024

清除剪貼簿，並釋放剪貼簿中的數據句柄。然後函式會將剪貼簿的擁有權指派給目前開啟剪貼簿的視窗。

Syntax

BOOL EmptyClipboard();

傳回值

類型： BOOL

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

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

備註

呼叫 EmptyClipboard 之前，應用程式必須使用 OpenClipboard 函式開啟剪貼簿。如果應用程式在開啟剪貼簿時指定 NULL 視窗句柄， EmptyClipboard 就會成功，但會將剪貼簿擁有者設定為 NULL。請注意，這會導致 SetClipboardData 失敗。

範例

如需範例，請參閱將資訊複製到剪貼簿。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	winuser.h (包括 Windows.h)
程式庫	User32.lib
Dll	User32.dll
API 集合	ext-ms-win-ntuser-misc-l1-2-0 (於 Windows 8.1)