|
OleConvertIStorageToOLESTREAM
Converts the specified storage object from OLE 2 structured storage to the OLE
1 storage model but does not include the presentation data. This is one of
several compatibility functions. You can use these functions to determine if an
object class is from OLE 1 and to convert objects between OLE 1 and OLE 2 storage
formats.
HRESULT OleConvertIStorageToOLESTREAM(
IStorage * pStg,
| //Points to the OLE 2 storage object to be converted
| LPOLESTREAM lpolestm
| //Points to the stream where the OLE1 storage is written
| );
|
|
Parameters
pStg
Points to the storage object to be converted to an OLE 1 storage.
lpolestm
Points to a stream where the persistent representation of the object is saved
using the OLE 1 storage model.
Return Values
S_OK
Indicates the storage object was successfully converted and the OLESTREAM structure contains the persistent representation of an OLE 1 object.
CONVERT10_E_STG_NO_STD_STREAM
Indicates object cannot be converted because its storage is missing a stream.
CONVERT10_S_NO_PRESENTATION
Indicates the specified storage object contains a Paintbrush object in DIB
format and there is no presentation data in the OLESTREAM.
E_INVALIDARG
Indicates invalid value for the pstg or lpolestm parameters.
Comments
This function converts an OLE 2 storage object to OLE 1 format. The OLESTREAM code implemented for OLE 1 must be available.
On entry, the stream pointed to by lpolestm should be created and positioned just as it would be for an OleSaveToStream call. On exit, the stream contains the persistent representation of the
object using OLE 1 storage.
Note Paintbrush objects are dealt with differently from other objects because
their native data is in DIB format. When Paintbrush objects are converted using OleConvertIStorageToOLESTREAM, no presentation data is added to the OLESTREAM. To include presentation data, use the OleConvertIStorageToOLESTREAMEx function instead.
See Also
CoIsOle1Class, OleConvertIStorageToOLESTREAMEx, OleConvertOLESTREAMToIStorage, OleConvertOLESTREAMToIStorageEx
Related LinksSoftware for Delphi and C++ Builder developers Software for Visual Studio .NET developers Software for Visual Basic 6 developers Delphi Tips&Tricks
MegaDetailed.NET
TMS Scripter Studio Pro components for Delphi/C++Builder
More Online Helps Win32 Programmer's Reference (win32.hlp) Win32 Multimedia Programmer's Reference (mmedia.hlp) Microsoft Windows Pen API Programmer's Reference (penapi.hlp) Microsoft Windows Sockets 2 Reference (sock2.hlp) Microsoft Windows Telephony API (TAPI) Programmer's Reference (sock2.hlp) Unix Manual Pages
|