SetMetaFileBitsEx-Funktion (wingdi.h)

2024-03-09

Die SetMetaFileBitsEx-Funktion erstellt eine speicherbasierte Metadatei im Windows-Format aus den bereitgestellten Daten.

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

Syntax

HMETAFILE SetMetaFileBitsEx(
  [in] UINT       cbBuffer,
  [in] const BYTE *lpData
);

Parameter

[in] cbBuffer

Gibt die Größe der Metadatei im Windows-Format in Bytes an.

[in] lpData

Zeiger auf einen Puffer, der die Metadatei im Windows-Format enthält. (Es wird davon ausgegangen, dass die Daten mithilfe der GetMetaFileBitsEx-Funktion abgerufen wurden.)

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für eine speicherbasierte Metadatei im Windows-Format.

Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL.

Hinweise

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

Wenn die Anwendung das von SetMetaFileBitsEx zurückgegebene Metadateihandle nicht mehr benötigt, sollte es durch Aufrufen der DeleteMetaFile-Funktion gelöscht werden.

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