OpenClipboard-Funktion (winuser.h)

Artikel
03/06/2024

Öffnet die Zwischenablage zur Prüfung und verhindert, dass andere Anwendungen den Inhalt der Zwischenablage ändern.

Syntax

BOOL OpenClipboard(
  [in, optional] HWND hWndNewOwner
);

Parameter

[in, optional] hWndNewOwner

Typ: HWND

Ein Handle für das Fenster, das der geöffneten Zwischenablage zugeordnet werden soll. Wenn dieser Parameter NULL ist, wird die geöffnete Zwischenablage der aktuellen Aufgabe zugeordnet.

Rückgabewert

Typ: BOOL

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

OpenClipboard schlägt fehl, wenn die Zwischenablage in einem anderen Fenster geöffnet ist.

Eine Anwendung sollte die CloseClipboard-Funktion nach jedem erfolgreichen Aufruf von OpenClipboard aufrufen.

Das durch den hWndNewOwner-Parameter identifizierte Fenster wird nicht zum Besitzer der Zwischenablage, es sei denn, die EmptyClipboard-Funktion wird aufgerufen.

Wenn eine Anwendung OpenClipboard aufruft, wobei hwnd auf NULL festgelegt ist, legt EmptyClipboard den Besitzer der Zwischenablage auf NULL fest. Dies führt dazu, dass SetClipboardData fehlschlägt .

Beispiele

Ein Beispiel finden Sie unter Kopieren von Informationen in die Zwischenablage.

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 (einschließlich Windows.h)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-misc-l1-2-0 (eingeführt in Windows 8.1)