CloseMetaFile-Funktion (wingdi.h)

Artikel
08/27/2023

Die CloseMetaFile-Funktion schließt einen Metadateigerätekontext und gibt ein Handle zurück, das eine Metadatei im Windows-Format identifiziert.

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 CloseEnhMetaFile.

Syntax

HMETAFILE CloseMetaFile(
  [in] HDC hdc
);

Parameter

[in] hdc

Handle für einen Metadateigerätekontext, der zum Erstellen einer Metadatei im Windows-Format verwendet wird.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für eine Metadatei im Windows-Format.

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

Hinweise

Verwenden Sie die Funktion SetWinMetaFileBits , um eine Metadatei im Windows-Format in eine neue Metadatei im erweiterten Format zu konvertieren.

Wenn eine Anwendung das Metadateihandle im Windows-Format nicht mehr benötigt, sollte sie das Handle durch Aufrufen der DeleteMetaFile-Funktion löschen.

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