The following table shows the return values for this method.

This method initializes an object from an existing storage. The object is placed in the loaded state if this method is called by the container application. If called by the default handler, this method places the object in the running state.

Either the default handler or the object itself can hold onto the IStoragepointer while the object is loaded or running.

To determine whether the platform supports this interface, see Determining Supported COM APIs.

Notes to Callers

The container should cache the IPersistStoragepointer for use in later operations on the object.

Notes to Implementers

Your implementation should perform the following steps to load an object:

1. Open the object's streams in the storage object, and read the necessary data into the object's internal data structures.
   
   
2. Clear the object's dirty flag.
   
   
3. Call the IPersistStorage::AddRefmethod and cache the passed in storage pointer.
   
   
4. Keep open and cache the pointers to any streams or storages that the object will need to save itself to this storage.
   
   
5. Perform any other default initialization required for the object.
   
   

Steps 3 and 4 are particularly important for ensuring that the object can save itself in low memory situations. Holding onto pointers to the storage and stream interfaces guarantees that a save operation to this storage will not fail due to insufficient memory.

Your implementation of this method should return the CO_E_ALREADYINITIALIZED error code if it receives a call to either the IPersistStorage::InitNewmethod or the IPersistStorage::Loadmethod after it is already initialized.