CopyEnhMetaFileW-Funktion (wingdi.h)

Die CopyEnhMetaFile-Funktion kopiert den Inhalt einer Metadatei im erweiterten Format in eine angegebene Datei.

Syntax

HENHMETAFILE CopyEnhMetaFileW(
  [in] HENHMETAFILE hEnh,
  [in] LPCWSTR      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 Arbeitsspeicher kopiert.

Rückgabewert

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

Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL.

Hinweise

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 im Arbeitsspeicher gespeicherte Metadateien für temporäre Vorgänge verwenden.

Wenn die Anwendung das Handle der erweiterten Metadatei nicht mehr benötigt, sollte sie das Handle löschen, indem sie die DeleteEnhMetaFile-Funktion aufruft.

Hinweis

Der wingdi.h-Header definiert CopyEnhMetaFile 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 nicht codierungsneutralem Code 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
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 (einschließlich Windows.h)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll

Weitere Informationen

DeleteEnhMetaFile

Metadateifunktionen

Übersicht über Metadateien