EmptyClipboard 関数 (winuser.h)

クリップボードを空にし、クリップボード内のデータにハンドルを解放します。 次に、 関数はクリップボードの所有権を、現在クリップボードが開いているウィンドウに割り当てます。

構文

BOOL EmptyClipboard();

戻り値

種類: BOOL

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

EmptyClipboard を呼び出す前に、アプリケーションで OpenClipboard 関数を使用してクリップボードを開く必要があります。 クリップボードを開くときにアプリケーションで NULL ウィンドウ ハンドルが指定されている場合、 EmptyClipboard は成功しますが、クリップボードの所有者を NULL に設定します。 これにより SetClipboardData が失敗します。

例

例については、「 クリップボードへの情報のコピー」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	winuser.h (Windows.h を含む)
Library	User32.lib
[DLL]	User32.dll
API セット	ext-ms-win-ntuser-misc-l1-2-0 (Windows 8.1で導入)

関連項目

クリップボード

概念

OpenClipboard

リファレンス

SetClipboardData

WM_DESTROYCLIPBOARD