GetEnhMetaFileA-Funktion (wingdi.h)

Artikel
11/20/2024

Die GetEnhMetaFile--Funktion erstellt ein Handle, das die in der angegebenen Datei gespeicherte Metadatei im erweiterten Format identifiziert.

Syntax

HENHMETAFILE GetEnhMetaFileA(
  [in] LPCSTR lpName
);

Parameter

[in] lpName

Ein Zeiger auf eine mit Null beendete Zeichenfolge, die den Namen einer erweiterten Metadatei angibt.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für die erweiterte Metadatei.

Wenn die Funktion fehlschlägt, ist der Rückgabewert NULL-.

Bemerkungen

Wenn die Anwendung kein Handle mit erweiterten Metadateien mehr benötigt, sollte sie das Handle löschen, indem sie die DeleteEnhMetaFile--Funktion aufruft.

Eine Windows-Format-Metadatei muss in das erweiterte Format konvertiert werden, bevor sie von der GetEnhMetaFile--Funktion verarbeitet werden kann. Verwenden Sie zum Konvertieren der Datei die SetWinMetaFileBits--Funktion.

Wenn Textargumente Unicode-Zeichen verwenden müssen, verwenden Sie diese Funktion als Breitzeichenfunktion. Wenn Textargumente Zeichen aus dem Windows-Zeichensatz verwenden müssen, verwenden Sie diese Funktion als ANSI-Funktion.

Beispiele

Ein Beispiel finden Sie unter Öffnen einer erweiterten Metadatei und Anzeigen des Inhalts.

Anmerkung

The wingdi.h header defines GetEnhMetaFile as an alias that automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. 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-	wingdi.h (enthalten Windows.h)
Library	Gdi32.lib
DLL-	Gdi32.dll