EnumMetaFile-Funktion (wingdi.h)

Artikel
03/06/2024

Die EnumMetaFile-Funktion listet die Datensätze in einer Metadatei im Windows-Format auf, indem sie jeden Datensatz abruft und an die angegebene Rückruffunktion übergibt. Die von der Anwendung bereitgestellte Rückruffunktion verarbeitet jeden Datensatz nach Bedarf. Die Enumeration wird fortgesetzt, bis der letzte Datensatz verarbeitet wurde oder wenn die Rückruffunktion null zurückgibt.

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

Syntax

BOOL EnumMetaFile(
  [in] HDC        hdc,
  [in] HMETAFILE  hmf,
  [in] MFENUMPROC proc,
  [in] LPARAM     param
);

Parameter

[in] hdc

Handle für einen Gerätekontext. Dieses Handle wird an die Rückruffunktion übergeben.

[in] hmf

Behandeln Sie eine Metadatei im Windows-Format.

[in] proc

Zeiger auf eine von der Anwendung bereitgestellte Rückruffunktion. Weitere Informationen finden Sie unter EnumMetaFileProc.

[in] param

Zeiger auf optionale Daten.

Rückgabewert

Wenn die Rückruffunktion erfolgreich alle Datensätze in der Metadatei im Windows-Format auflistet, ist der Rückgabewert nonzero.

Wenn die Rückruffunktion nicht erfolgreich alle Datensätze in der Metadatei im Windows-Format aufzählt, ist der Rückgabewert 0.

Hinweise

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

Sie können die EnumMetaFile-Funktion verwenden, um eine Metadatei im Windows-Format in eine andere einzubetten.

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