CopyEnhMetaFileA-Funktion (wingdi.h)
Die CopyEnhMetaFile--Funktion kopiert den Inhalt einer Metadatei im erweiterten Format in eine angegebene Datei.
Syntax
HENHMETAFILE CopyEnhMetaFileA(
[in] HENHMETAFILE hEnh,
[in] LPCSTR lpFileName
);
Parameter
[in] hEnh
Ein Handle für die erweiterte Metadatei, die kopiert werden soll.
[in] lpFileName
Ein Zeiger auf den Namen der Zieldatei. Wenn dieser Parameter NULL-ist, wird die Quellmetadatei in den Speicher kopiert.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für die Kopie der erweiterten Metadatei.
Wenn die Funktion fehlschlägt, ist der Rückgabewert NULL-.
Bemerkungen
Wenn Textargumente Unicode-Zeichen verwenden müssen, verwenden Sie die CopyEnhMetaFile Funktion als Breitzeichenfunktion. Wenn Textargumente Zeichen aus dem Windows-Zeichensatz verwenden müssen, verwenden Sie diese Funktion als ANSI-Funktion.
Anwendungen können Metadateien verwenden, die im Speicher für temporäre Vorgänge gespeichert sind.
Wenn die Anwendung nicht mehr das Handle für die erweiterte Metadatei benötigt, sollte sie das Handle löschen, indem sie die DeleteEnhMetaFile--Funktion aufruft.
Anmerkung
Der wingdi.h-Header definiert CopyEnhMetaFile als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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- | wingdi.h (enthalten Windows.h) |
| Library | Gdi32.lib |
| DLL- | Gdi32.dll |
Siehe auch
übersicht über Metadateien