Freigeben über


CloseMetaFile-Funktion (wingdi.h)

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

Weitere Informationen

CloseEnhMetaFile

CopyMetaFile

CreateMetaFile

DeleteMetaFile

EnumMetaFile

GetMetaFileBitsEx

Metafilefunktionen

Übersicht über Metadateien

PlayMetaFile

SetWinMetaFileBits