GetClipboardFormatNameA-Funktion (winuser.h)
Ruft aus der Zwischenablage den Namen des angegebenen registrierten Formats ab. Die Funktion kopiert den Namen in den angegebenen Puffer.
Syntax
int GetClipboardFormatNameA(
[in] UINT format,
[out] LPSTR lpszFormatName,
[in] int cchMaxCount
);
Parameter
[in] format
Typ: UINT-
Der Typ des abzurufenden Formats. Dieser Parameter darf keines der vordefinierten Zwischenablageformate angeben.
[out] lpszFormatName
Typ: LPTSTR-
Der Puffer, der den Formatnamen empfängt.
[in] cchMaxCount
Typ: int
Die maximale Länge der Zeichenfolge, die in Zeichen in den Puffer kopiert werden soll. Wenn der Name diesen Grenzwert überschreitet, wird er abgeschnitten.
Rückgabewert
Typ: int
Wenn die Funktion erfolgreich ist, ist der Rückgabewert die Länge der in den Puffer kopierten Zeichenfolge in Zeichen.
Wenn die Funktion fehlschlägt, ist der Rückgabewert null, der angibt, dass das angeforderte Format nicht vorhanden ist oder vordefinierte ist. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.
Bemerkungen
Sicherheitsüberlegungen
Die Verwendung dieser Funktion kann die Sicherheit Ihres Programms beeinträchtigen. Beispielsweise kann die Fehlberechnung der richtigen Größe des lpszFormatName Puffers führen, insbesondere wenn die Anwendung in ANSI- und Unicode-Versionen verwendet wird, zu einem Pufferüberlauf führen. Beachten Sie außerdem, dass die Zeichenfolge abgeschnitten wird, wenn sie länger als der cchMaxCount Parameter ist, der zu Einem Verlust von Informationen führen kann.Beispiele
Ein Beispiel finden Sie unter Beispiel für einen Zwischenablage-Viewer.
Anmerkung
Der winuser.h-Header definiert GetClipboardFormatName als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 2000 Professional [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | winuser.h (enthalten Windows.h) |
| Library | User32.lib |
| DLL- | User32.dll |
| API-Satz | ext-ms-win-ntuser-misc-l1-1-0 (eingeführt in Windows 8) |
Siehe auch
Konzeptionelle
Referenz-