Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

ChangeClipboardChain function

Removes a specified window from the chain of clipboard viewers.

Syntax


BOOL WINAPI ChangeClipboardChain(
  _In_  HWND hWndRemove,
  _In_  HWND hWndNewNext
);

Parameters

hWndRemove [in]

Type: HWND

A handle to the window to be removed from the chain. The handle must have been passed to the SetClipboardViewer function.

hWndNewNext [in]

Type: HWND

A handle to the window that follows the hWndRemove window in the clipboard viewer chain. (This is the handle returned by SetClipboardViewer, unless the sequence was changed in response to a WM_CHANGECBCHAIN message.)

Return value

Type: BOOL

The return value indicates the result of passing the WM_CHANGECBCHAIN message to the windows in the clipboard viewer chain. Because a window in the chain typically returns FALSE when it processes WM_CHANGECBCHAIN, the return value from ChangeClipboardChain is typically FALSE. If there is only one window in the chain, the return value is typically TRUE.

Remarks

The window identified by hWndNewNext replaces the hWndRemove window in the chain. The SetClipboardViewer function sends a WM_CHANGECBCHAIN message to the first window in the clipboard viewer chain.

For an example, see Removing a Window from the Clipboard Viewer Chain.

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
ChangeClipboardChain
SetClipboardViewer
WM_CHANGECBCHAIN
Conceptual
Clipboard

 

 

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

Show:
© 2014 Microsoft