ChangeClipboardChain-Funktion (winuser.h)

Artikel
03/13/2024

Entfernt ein angegebenes Fenster aus der Kette von Zwischenablage-Viewern.

Syntax

BOOL ChangeClipboardChain(
  [in] HWND hWndRemove,
  [in] HWND hWndNewNext
);

Parameter

[in] hWndRemove

Typ: HWND

Ein Handle für das Fenster, das aus der Kette entfernt werden soll. Das Handle muss an die SetClipboardViewer-Funktion übergeben worden sein.

[in] hWndNewNext

Typ: HWND

Ein Handle für das Fenster, das dem hWndRemove-Fenster in der Zwischenablageanzeigekette folgt. (Dies ist das von SetClipboardViewer zurückgegebene Handle, es sei denn, die Sequenz wurde als Reaktion auf eine WM_CHANGECBCHAIN Nachricht geändert.)

Rückgabewert

Typ: BOOL

Der Rückgabewert gibt das Ergebnis der Übergabe der WM_CHANGECBCHAIN-Nachricht an die Fenster in der Zwischenablageanzeigekette an. Da ein Fenster in der Kette normalerweise FALSE zurückgibt, wenn es WM_CHANGECBCHAIN verarbeitet, ist der Rückgabewert aus ChangeClipboardChain in der Regel FALSE. Wenn nur ein Fenster in der Kette vorhanden ist, ist der Rückgabewert in der Regel TRUE.

Hinweise

Das durch hWndNewNext identifizierte Fenster ersetzt das Fenster hWndRemove in der Kette. Die SetClipboardViewer-Funktion sendet eine WM_CHANGECBCHAIN Nachricht an das erste Fenster in der Zwischenablageanzeigekette.

Ein Beispiel finden Sie unter Entfernen eines Fensters aus der Zwischenablageanzeigekette.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (windows.h einschließen)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-misc-l1-5-1 (eingeführt in Windows 10, Version 10.0.14393)