OpenClipboard-Funktion (winuser.h)
Ö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) |
Weitere Informationen
Konzept
Referenz