Export (0) Print
Expand All

EmptyClipboard function

Empties the clipboard and frees handles to data in the clipboard. The function then assigns ownership of the clipboard to the window that currently has the clipboard open.

Syntax


BOOL WINAPI EmptyClipboard(void);

Parameters

This function has no parameters.

Return value

Type: BOOL

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

Before calling EmptyClipboard, an application must open the clipboard by using the OpenClipboard function. If the application specifies a NULL window handle when opening the clipboard, EmptyClipboard succeeds but sets the clipboard owner to NULL. Note that this causes SetClipboardData to fail.

Examples

For an example, see Copying Information to the Clipboard.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Winuser.h (include Windows.h)

Library

User32.lib

DLL

User32.dll

See also

Reference
OpenClipboard
SetClipboardData
WM_DESTROYCLIPBOARD
Conceptual
Clipboard

 

 

Community Additions

ADD
Show:
© 2014 Microsoft