Freigeben über


SetMetaFileBitsEx-Funktion (wingdi.h)

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

Weitere Informationen

DeleteMetaFile

GetMetaFileBitsEx

Metadateifunktionen

Übersicht über Metadateien

SetEnhMetaFileBits

SetWinMetaFileBits