OleConvertIStorageToOLESTREAMEx-Funktion (ole2.h)

Artikel
08/25/2023

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