GetMetaFileBitsEx-Funktion (wingdi.h)

Artikel
03/06/2024

Die GetMetaFileBitsEx-Funktion ruft den Inhalt einer Metadatei im Windows-Format ab und kopiert sie in den angegebenen Puffer.

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

Syntax

UINT GetMetaFileBitsEx(
  [in]  HMETAFILE hMF,
  [in]  UINT      cbBuffer,
  [out] LPVOID    lpData
);

Parameter

[in] hMF

Ein Handle für eine Metadatei im Windows-Format.

[in] cbBuffer

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 lpvDataNULL ist, gibt die Funktion die Anzahl der Bytes zurück, die zum Aufnehmen der Daten erforderlich sind.

Rückgabewert

Wenn die Funktion erfolgreich ist und der Pufferzeiger NULL ist, ist der Rückgabewert die Anzahl von Bytes, die für den Puffer erforderlich sind. wenn die Funktion erfolgreich ist und der Pufferzeiger ein gültiger Zeiger ist, ist der Rückgabewert die Anzahl der kopierten Bytes.

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

Hinweise

Nachdem die Windows-Metadateibits abgerufen wurden, können sie verwendet werden, um eine speicherbasierte Metadatei zu erstellen, indem die SetMetaFileBitsEx-Funktion aufgerufen wird.

Die GetMetaFileBitsEx-Funktion ungültigiert das Metadateihandle nicht. Eine Anwendung muss dieses Handle löschen, indem sie die DeleteMetaFile-Funktion aufruft.

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

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