CopyMetaFileW-Funktion (wingdi.h)
Die CopyMetaFile--Funktion kopiert den Inhalt einer Windows-Format-Metadatei in die angegebene Datei.
Syntax
HMETAFILE CopyMetaFileW(
[in] HMETAFILE unnamedParam1,
[in] LPCWSTR unnamedParam2
);
Parameter
[in] unnamedParam1
Ein Handle zur Windows-Quellmetadatei im Windows-Format.
[in] unnamedParam2
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 Windows-Format-Metadatei.
Wenn die Funktion fehlschlägt, ist der Rückgabewert NULL-.
Bemerkungen
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.
Wenn die Anwendung das Metadateihandle im Windows-Format nicht mehr benötigt, sollte sie das Handle löschen, indem sie die DeleteMetaFile--Funktion aufruft.
Anmerkung
Der wingdi.h-Header definiert CopyMetaFile 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- | wingdi.h (enthalten Windows.h) |
| Library | Gdi32.lib |
| DLL- | Gdi32.dll |
Siehe auch
übersicht über Metadateien