GetMetaFileA-Funktion (wingdi.h)
[GetMetaFile steht ab Windows 2000 nicht mehr zur Verfügung. Verwenden Sie stattdessen GetEnhMetaFile.]
Die GetMetaFile--Funktion erstellt ein Handle, das die in der angegebenen Datei gespeicherte Metadatei identifiziert.
Syntax
HMETAFILE GetMetaFileA(
[in] LPCSTR lpName
);
Parameter
[in] lpName
Ein Zeiger auf eine mit Null beendete Zeichenfolge, die den Namen einer Metadatei angibt.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für die Metadatei.
Wenn die Funktion fehlschlägt, ist der Rückgabewert NULL-.
Bemerkungen
Diese Funktion ist in der Win32-API nicht implementiert. Es wird zur Kompatibilität mit 16-Bit-Versionen von Windows bereitgestellt. Verwenden Sie in Win32-Anwendungen die GetEnhMetaFile--Funktion.
Anmerkung
The wingdi.h header defines GetMetaFile as an alias that automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. 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 |
|---|---|
| Zielplattform- | Fenster |
| Header- | wingdi.h (enthalten Windows.h) |
| Library | Gdi32.lib |
| DLL- | Gdi32.dll |