GetClipboardData-Funktion (winuser.h)

Artikel
08/27/2023

Ruft Daten in einem angegebenen Format aus der Zwischenablage ab. Die Zwischenablage muss zuvor geöffnet worden sein.

Syntax

HANDLE GetClipboardData(
  [in] UINT uFormat
);

Parameter

[in] uFormat

Typ: UINT

Ein Zwischenablageformat. Eine Beschreibung der Standardformate der Zwischenablage finden Sie unter Standard-Zwischenablageformate.

Rückgabewert

Typ: HANDLE

Wenn die Funktion erfolgreich ist, ist der Rückgabewert das Handle für ein Zwischenablageobjekt im angegebenen Format.

Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Vorsicht Zwischenablagedaten sind nicht vertrauenswürdig. Analysieren Sie die Daten sorgfältig, bevor Sie sie in Ihrer Anwendung verwenden.

Eine Anwendung kann die verfügbaren Formate im Voraus mit der EnumClipboardFormats-Funktion auflisten.

Die Zwischenablage steuert das Handle, das die GetClipboardData-Funktion zurückgibt, nicht die Anwendung. Die Anwendung sollte die Daten sofort kopieren. Die Anwendung darf das Handle weder freigeben noch gesperrt lassen. Die Anwendung darf das Handle nicht verwenden, nachdem die Funktion EmptyClipboard oder CloseClipboard aufgerufen wurde oder nachdem die SetClipboardData-Funktion mit demselben Zwischenablageformat aufgerufen wurde.

Das System führt implizite Datenformatkonvertierungen zwischen bestimmten Zwischenablageformaten durch, wenn eine Anwendung die GetClipboardData-Funktion aufruft . Wenn sich beispielsweise das CF_OEMTEXT Format in der Zwischenablage befindet, kann ein Fenster Daten im CF_TEXT Format abrufen. Das Format in der Zwischenablage wird bei Bedarf in das angeforderte Format konvertiert. Weitere Informationen finden Sie unter Synthetisierte Zwischenablageformate.

Beispiele

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

Anforderungen


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-2-0 (eingeführt in Windows 8.1)