GetEnhMetaFileBits-Funktion (wingdi.h)
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 |