OpenClipboard
The OpenClipboard
function opens the clipboard for examination and prevents other applications
from modifying the clipboard content.
BOOL OpenClipboard(
HWND hWndNewOwner |
// handle to window
opening clipboard |
); |
|
Parameters
hWndNewOwner
Identifies
the window to be associated with the open clipboard. If this parameter is NULL,
the open clipboard is associated with the current task.
Return Values
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
OpenClipboard fails if another window has the clipboard open.
An
application should call the CloseClipboard function after every successful
call to OpenClipboard.
The window
identified by the hWndNewOwner parameter does not become the clipboard
owner unless the EmptyClipboard function is called.
See Also