CloseEnhMetaFile-Funktion (wingdi.h)

Artikel
03/04/2024

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