OleConvertOLESTREAMToIStorageEx-Funktion (ole2.h)

Artikel
02/29/2024

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