IPersistStream::Load method (objidl.h)
Initializes an object from the stream where it was saved previously.
HRESULT Load( [in] IStream *pStm );
An IStream pointer to the stream from which the object should be loaded.
This method can return the following values.
||The method completed successfully.|
||The object was not loaded due to lack of memory.|
||The object was not loaded due to some reason other than a lack of memory.|
This method loads an object from its associated stream. The seek pointer is set as it was in the most recent IPersistStream::Save method. This method can seek and read from the stream, but cannot write to it.OleLoadFromStream function does the following:
- Calls the ReadClassStm function to get the class identifier from the stream.
- Calls the CoCreateInstance function to create an instance of the object.
- Queries the instance for IPersistStream.
- Calls IPersistStream::Load.
If the objects are not stored using this pattern, you must call the methods separately yourself.IPersistStream::Save (using OleSaveToStream). The binary format of the URL moniker is its URL string in Unicode (may be a full or partial URL string, see CreateURLMonikerEx for details). This is represented as a ULONG count of characters followed by that many Unicode characters.
|Minimum supported client||Windows 2000 Professional [desktop apps only]|
|Minimum supported server||Windows 2000 Server [desktop apps only]|