OleConvertIStorageToOLESTREAMEx-Funktion (ole2.h)
Die OleConvertIStorageToOLESTREAMEx-Funktion konvertiert das angegebene Speicherobjekt vom strukturierten OLE 2-Speicher in das OLE 1-Speicherobjektmodell, einschließlich der Präsentationsdaten. Dies ist eine von mehreren Funktionen, die in Strukturiertem Speicher enthalten sind, um die Kompatibilität zwischen OLE1 und OLE2 sicherzustellen.
Syntax
HRESULT OleConvertIStorageToOLESTREAMEx(
[in] LPSTORAGE pstg,
[in] CLIPFORMAT cfFormat,
[in] LONG lWidth,
[in] LONG lHeight,
[in] DWORD dwSize,
[in] LPSTGMEDIUM pmedium,
[out] LPOLESTREAM polestm
);
Parameter
[in] pstg
Zeiger auf die IStorage-Schnittstelle des Speicherobjekts, das in einen OLE 1-Speicher konvertiert werden soll.
[in] cfFormat
Format der Präsentationsdaten. Kann NULL sein. In diesem Fall werden die Parameter lWidth, lHeight, dwSize und pmedium ignoriert.
[in] lWidth
Breite der Objektpräsentationsdaten in HIMETRIC-Einheiten.
[in] lHeight
Höhe der Objektpräsentationsdaten in HIMETRIC-Einheiten.
[in] dwSize
Größe der zu konvertierenden Daten in Bytes.
[in] pmedium
Zeiger auf die STGMEDIUM-Struktur für die serialisierten Daten, die konvertiert werden sollen.
[out] polestm
Zeiger auf einen Stream, in dem die persistente Darstellung des Objekts mithilfe des OLE 1-Speichermodells gespeichert wird.
Rückgabewert
Diese Funktion unterstützt zusätzlich folgendes den Standardrückgabewert E_INVALIDARG:
Hinweise
Die OleConvertIStorageToOLESTREAMEx-Funktion konvertiert ein OLE 2-Speicherobjekt in das OLE 1-Format. Sie unterscheidet sich von der OleConvertIStorageToOLESTREAM-Funktion dadurch, dass die OleConvertIStorageToOLESTREAMEx-Funktion auch die Präsentationsdaten an das OLE 1-Speicherobjekt übergibt, während die OleConvertIStorageToOLESTREAM-Funktion dies nicht tut.
Da OleConvertIStorageToOLESTREAMEx angeben kann, welche Präsentationsdaten konvertiert werden sollen, kann es von Anwendungen verwendet werden, die keine OLE-Standardzwischenspeicherressourcen verwenden, aber die Konvertierungsressourcen von OLE verwenden.
Der Wert des tymed-Members von STGMEDIUM muss entweder TYMED_HGLOBAL oder TYMED_ISTREAM sein. Weitere Informationen finden Sie in der TYMED-Enumeration . Das Medium wird nicht von der OleConvertIStorageToOLESTREAMEx-Funktion freigegeben.
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 | ole2.h |
| Bibliothek | Ole32.lib |
| DLL | Ole32.dll |