GetEnhMetaFileHeader-Funktion (wingdi.h)

Die GetEnhMetaFileHeader-Funktion ruft den Datensatz ab, der den Header für die angegebene Metadatei im erweiterten Format enthält.

Syntax

UINT GetEnhMetaFileHeader(
  [in]  HENHMETAFILE    hemf,
  [in]  UINT            nSize,
  [out] LPENHMETAHEADER lpEnhMetaHeader
);

Parameter

[in] hemf

Ein Handle für die erweiterte Metadatei, für die der Header abgerufen werden soll.

[in] nSize

Die Größe des Puffers, der die Daten empfangen soll, in Bytes. Nur so viele Bytes werden kopiert.

[out] lpEnhMetaHeader

Ein Zeiger auf eine ENHMETAHEADER-Struktur , die den Headerdatensatz empfängt. Wenn dieser Parameter NULL ist, gibt die Funktion die Größe des Headerdatensatzes zurück.

Rückgabewert

Wenn die Funktion erfolgreich ist und der Strukturzeiger NULL ist, entspricht der Rückgabewert der Größe des Datensatzes, der den Header enthält. Wenn der Strukturzeiger ein gültiger Zeiger ist, ist der Rückgabewert die Anzahl der kopierten Bytes. Andernfalls ist er null.

Hinweise

Ein enhanced-metafile-Header enthält Informationen wie die Größe der Metadatei in Bytes. die Abmessungen des in der Metadatei gespeicherten Bilds; die Anzahl der in der Metadatei gespeicherten Datensätze; der Offset zur optionalen Textbeschreibung; die Größe der optionalen Palette und die Auflösung des Geräts, auf dem das Bild erstellt wurde.

Der Datensatz, der den enhanced-metafile-Header enthält, ist immer der erste Datensatz in der Metadatei.

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 (windows.h einschließen)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll

Weitere Informationen

ENHMETAHEADER

Metafilefunktionen

Übersicht über Metadateien

PlayEnhMetaFile