CloseEnhMetaFile-Funktion (wingdi.h)

Die CloseEnhMetaFile-Funktion schließt einen Gerätekontext der erweiterten Metadatei und gibt ein Handle zurück, das eine Metadatei im erweiterten Format identifiziert.

Syntax

HENHMETAFILE CloseEnhMetaFile(
  [in] HDC hdc
);

Parameter

[in] hdc

Verarbeiten eines Gerätekontexts mit erweiterter Metadatei.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für eine erweiterte Metadatei.

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

Hinweise

Eine Anwendung kann das von der CloseEnhMetaFile-Funktion zurückgegebene Handle der erweiterten Metadatei verwenden, um die folgenden Aufgaben auszuführen:

  • Anzeigen eines in einer erweiterten Metadatei gespeicherten Bilds
  • Erstellen von Kopien der erweiterten Metadatei
  • Auflisten, Bearbeiten oder Kopieren einzelner Datensätze in der erweiterten Metadatei
  • Abrufen einer optionalen Beschreibung des Metadateiinhalts aus dem enhanced-metafile-Header
  • Abrufen einer Kopie des Headers der erweiterten Metadatei
  • Abrufen einer binären Kopie der erweiterten Metadatei
  • Auflisten der Farben in der optionalen Palette
  • Konvertieren einer Metadatei im erweiterten Format in eine Metadatei im Windows-Format
Wenn die Anwendung das erweiterte Metadateihandle nicht mehr benötigt, sollte sie das Handle durch Aufrufen der DeleteEnhMetaFile-Funktion freigeben.

Anforderungen

Anforderung Wert
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 (einschließlich Windows.h)
Bibliothek Gdi32.lib
DLL Gdi32.dll

Weitere Informationen

CopyEnhMetaFile

CreateEnhMetaFile

DeleteEnhMetaFile

EnumEnhMetaFile

GetEnhMetaFileBits

GetWinMetaFileBits

Metadateifunktionen

Übersicht über Metadateien

PlayEnhMetaFile