GetClipboardOwner function

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

Syntax


HWND WINAPI GetClipboardOwner(void);

Parameters

This function has no parameters.

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

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
EmptyClipboard
GetClipboardViewer
Conceptual
Clipboard

 

 

Community Additions

ADD
Show:
© 2014 Microsoft