Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die CopyMetaFile--Funktion kopiert den Inhalt einer Windows-Format-Metadatei in die angegebene Datei.
Hinweis Diese Funktion wird nur zur Kompatibilität mit Metadateien im Windows-Format bereitgestellt. Erweiterte Metadateien bieten überlegene Funktionen und werden für neue Anwendungen empfohlen. Die entsprechende Funktion für eine Metadatei im erweiterten Format ist CopyEnhMetaFile.
Syntax
HMETAFILE CopyMetaFileA(
[in] HMETAFILE unnamedParam1,
[in] LPCSTR 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