Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |