CopyMetaFileW-Funktion (wingdi.h)

Artikel
08/27/2023

Die CopyMetaFile-Funktion kopiert den Inhalt einer Metadatei im Windows-Format in die angegebene Datei.

Hinweis Diese Funktion wird nur zur Kompatibilität mit Metadateien im Windows-Format bereitgestellt. Metadateien im erweiterten Format bieten überlegene Funktionen und werden für neue Anwendungen empfohlen. Die entsprechende Funktion für eine Metadatei im erweiterten Format ist CopyEnhMetaFile.

Syntax

HMETAFILE CopyMetaFileW(
  [in] HMETAFILE unnamedParam1,
  [in] LPCWSTR   unnamedParam2
);

Parameter

[in] unnamedParam1

Ein Handle für die Metadatei im Windows-Quellformat.

[in] unnamedParam2

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 Metadatei im Windows-Format.

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

Hinweise

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 durch Aufrufen der DeleteMetaFile-Funktion löschen.

Hinweis

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


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

Weitere Informationen

DeleteMetaFile

Metafilefunktionen

Übersicht über Metadateien

Share via