GetEnhMetaFileBits-Funktion (wingdi.h)

Artikel
08/27/2023

Die GetEnhMetaFileBits-Funktion ruft den Inhalt der angegebenen Metadatei im erweiterten Format ab und kopiert sie in einen Puffer.

Syntax

UINT GetEnhMetaFileBits(
  [in]  HENHMETAFILE hEMF,
  [in]  UINT         nSize,
  [out] LPBYTE       lpData
);

Parameter

[in] hEMF

Ein Handle für die erweiterte Metadatei.

[in] nSize

Die Größe des Puffers, der die Daten empfangen soll, in Bytes.

[out] lpData

Ein Zeiger auf einen Puffer, der die Metadatendaten empfängt. Der Puffer muss ausreichend groß sein, um die Daten zu enthalten. Wenn lpbBufferNULL ist, gibt die Funktion die Größe zurück, die zum Aufnehmen der Daten erforderlich ist.

Rückgabewert

Wenn die Funktion erfolgreich ist und der Pufferzeiger NULL ist, entspricht der Rückgabewert der Größe der erweiterten Metadatei in Bytes.

Wenn die Funktion erfolgreich ist und der Pufferzeiger ein gültiger Zeiger ist, ist der Rückgabewert die Anzahl der in den Puffer kopierten Bytes.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.

Hinweise

Nachdem die enhanced-metafile-Bits abgerufen wurden, können sie verwendet werden, um eine speicherbasierte Metadatei zu erstellen, indem die SetEnhMetaFileBits-Funktion aufgerufen wird.

Mit der GetEnhMetaFileBits-Funktion wird das Handle der erweiterten Metadatei nicht ungültig. Die Anwendung muss die DeleteEnhMetaFile-Funktion aufrufen, um das Handle zu löschen, wenn es nicht mehr benötigt wird.

Die metafile-Inhalte, die von dieser Funktion abgerufen werden, haben das erweiterte Format. Verwenden Sie die Funktion GetWinMetaFileBits , um den Inhalt der Metadatei im Windows-Format abzurufen.

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