GetClipboardOwner function (winuser.h)

Retrieves the window handle of the current owner of the clipboard.

Syntax

HWND GetClipboardOwner();

Return value

Type: HWND

If the function succeeds, the return value is the handle to the window that owns the clipboard.

If the clipboard is not owned, the return value is NULL. To get extended error information, call GetLastError.

Remarks

The clipboard can still contain data even if the clipboard is not currently owned.

In general, the clipboard owner is the window that last placed data in clipboard. The EmptyClipboard function assigns clipboard ownership.

Examples

For an example, see Example of a Clipboard Viewer.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header winuser.h (include Windows.h)
Library User32.lib
DLL User32.dll
API set ext-ms-win-ntuser-misc-l1-2-0 (introduced in Windows 8.1)

See also

Clipboard

Conceptual

EmptyClipboard

GetClipboardViewer

Reference