OleConvertOLESTREAMToIStorageEx-Funktion (ole2.h)
Die OleConvertOLESTREAMToIStorageEx-Funktion konvertiert das angegebene Objekt vom OLE 1-Speichermodell in ein strukturiertes OLE 2-Speicherobjekt einschließlich Präsentationsdaten. Dies ist eine von mehreren Kompatibilitätsfunktionen.
Syntax
HRESULT OleConvertOLESTREAMToIStorageEx(
[in] LPOLESTREAM polestm,
[out] LPSTORAGE pstg,
[out] CLIPFORMAT *pcfFormat,
[out] LONG *plwWidth,
[out] LONG *plHeight,
[out] DWORD *pdwSize,
[out] LPSTGMEDIUM pmedium
);
Parameter
[in] polestm
Zeiger auf den Stream, der die persistente Darstellung des Objekts im OLE 1-Speicherformat enthält.
[out] pstg
Zeiger auf das strukturierte OLE 2-Speicherobjekt.
[out] pcfFormat
Zeiger auf den Ort, an dem das Format der Präsentationsdaten zurückgegeben wird. Kann NULL sein, was auf das Fehlen von Präsentationsdaten hinweist.
[out] plwWidth
Zeiger auf den Ort, an dem der Breiteswert (in HIMETRIC) der Präsentationsdaten zurückgegeben wird.
[out] plHeight
Zeiger darauf, wo der Höhenwert (in HIMETRIC) der Präsentationsdaten zurückgegeben wird.
[out] pdwSize
Zeiger auf den Ort, an dem die Größe der konvertierten Daten in Bytes zurückgegeben wird.
[out] pmedium
Zeiger auf den Ort, an dem die STGMEDIUM-Struktur für die konvertierten serialisierten Daten zurückgegeben wird.
Rückgabewert
Diese Funktion gibt HRESULT zurück.
Hinweise
Diese Funktion konvertiert ein OLE 1-Objekt in ein strukturiertes OLE 2-Speicherobjekt. Sie können diese Funktion verwenden, um OLE 1-Objekte auf OLE 2-Objekte zu aktualisieren, wenn eine neue Version der Objektanwendung OLE 2 unterstützt.
Diese Funktion unterscheidet sich von der OleConvertOLESTREAMToIStorage-Funktion darin, dass die aus der OLESTREAM-Struktur gelesenen Präsentationsdaten übergeben werden und das neu erstellte OLE 2-Speicherobjekt keinen Präsentationsdatenstrom enthält.
Da diese Funktion angeben kann, welche Präsentationsdaten konvertiert werden sollen, kann sie von Anwendungen verwendet werden, die nicht die Standardzwischenspeicherungsressourcen von OLE verwenden, sondern die Konvertierungsressourcen verwenden.
Das tymed-Element von STGMEDIUM kann nur TYMED_NULL oder TYMED_ISTREAM sein. Wenn es TYMED_NULL ist, werden die Daten in einem globalen Handle über den hGlobal-Member von STGMEDIUM zurückgegeben. Andernfalls werden Daten in das pstm-Element dieser Struktur geschrieben.
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 |