GetEnhMetaFileA-Funktion (wingdi.h)
Die GetEnhMetaFile-Funktion erstellt ein Handle, das die Metadatei im erweiterten Format identifiziert, die in der angegebenen Datei gespeichert ist.
Syntax
HENHMETAFILE GetEnhMetaFileA(
[in] LPCSTR lpName
);
Parameter
[in] lpName
Ein Zeiger auf eine NULL-endende 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 bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL.
Hinweise
Wenn die Anwendung kein erweitertes Metadateihandle mehr benötigt, sollte sie das Handle durch Aufrufen der DeleteEnhMetaFile-Funktion löschen.
Eine Metadatei im Windows-Format 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 ihrer Inhalte.
Hinweis
Der wingdi.h-Header definiert GetEnhMetaFile 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
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | wingdi.h (windows.h einschließen) |
| Bibliothek | Gdi32.lib |
| DLL | Gdi32.dll |