Converts the specified object from the OLE 1 storage model to an OLE 2
structured storage object without specifying 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
| LPOLESTREAM lpolestm,
||//Points to the stream where the OLE 1 storage is written
| IStorage * pstg,
||//Points to OLE 2 storage object
| const DVTARGETDEVICE * ptd
||//Points to target device
Points to a stream that contains the persistent representation of the object
in the OLE 1 storage format.
Points to the OLE 2 structured storage object.
Points to the target device for which the OLE 1 object is rendered.
Indicates the object was successfully converted.
Indicates object either has no presentation data or uses native data for its
DV_E_DVTARGETDEVICE or DV_E_DVTARGETDEVICE_SIZE
Indicates invalid value for ptd
Indicates invalid value for lpolestm
This function converts an OLE 1 object to an OLE 2 structured storage object.
You can use this function to update OLE 1 objects to OLE 2 objects when a new
version of the object application supports OLE 2.
On entry, the lpolestm
parameter should be created and positioned just as it would be for an OleLoadFromStream
function call. On exit, the lpolestm
parameter is positioned just as it would be on exit from an OleLoadFromStream
function, and the pstg
parameter contains the uncommitted persistent representation of the OLE 2
For OLE 1 objects that use native data for their presentation, the OleConvertOLESTREAMToIStorage
function returns CONVERT10_S_NO_PRESENTATION. On receiving this return value,
callers should call IOleObject::Update
to get the presentation data so that it can be written to storage.
The following steps describe the conversion process:
- Create a root IStorage object by calling the StgCreateDocfile function(..., &pstg).
- Open the OLE 1 file (using OpenFile or another OLE 1 technique).
- Using the OLE 1 procedure for reading files, read from the file until an OLE
object is encountered.
- Allocate an IStorage object from the root IStorage created in step 1:
hRes = OleConvertIStorageToOLESTREAM(polestm, pStgChild);
hRes = OleLoad(pStgChild, &IID_IOleObject, pClientSite, ppvObj);
- Repeat step 3 until the file is completely read.
- Software for developers
Software for Android Developers
- More information resources
Unix Manual Pages