Share via


OpenClipboard

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function opens the clipboard for examination and prevents other applications from modifying the clipboard content.

Syntax

BOOL OpenClipboard(
  HWND hWndNewOwner
); 

Parameters

  • hWndNewOwner
    [in] Handle to the window to be associated with the open clipboard. If this parameter is NULL, the open clipboard is associated with the current task.

Return Value

Nonzero indicates success. Zero indicates failure.

Remarks

OpenClipboard does not fail if another window created by the same thread that created the window identified by hWndNewOwner already opened the clipboard.

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.

Requirements

Header winuser.h
Library Clipbd.lib
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

CloseClipboard
EmptyClipboard
Clipboards Functions