Embedded stores are represented by an instance of the CEmbeddedStore class.
A CEmbeddedStore object is constructed from a host stream.
When the CEmbeddedStore object represents a new embedded
store, it is constructed from an RWriteStream object; for
example, a class might include the following code fragment in one of its functions:
...
// create the stream to contain the embedded store
RStoreWriteStream childStream;
// we need to keep track of this stream id
iEmbeddedStoreId = childStream.CreateLC(iStore);
// construct the embedded store
CPersistentStore* embeddedStore = CEmbeddedStore::NewLC(childStream);
...
Here, the code assumes that iStore refers to the top level
store and iEmbeddedStoreId is a data member to hold the ID
of the hosting stream.
On successful construction, ownership of the host stream passes to the embedded store which means that the embedded store takes on the responsibility for closing the stream.
When the CEmbeddedStore object represents an existing
embedded store, it is constructed from an RReadStream object;
for example, a class might include the following code fragment in one of its
functions:
... RStoreReadStream childStream; childStream.OpenL(iStore,iEmbeddedStoreId); iEmbeddedStore = CEmbeddedStore::FromL(childStream); ...
Where:
iStore refers
to the top level store
iEmbeddedStoreId is
a data member that holds the ID of the hosting stream
iEmbeddedStore holds
a reference to the embedded store object.
When saving data, an application re-creates the embedded store by re-writing the complete partial object network to the embedded store, replacing any existing data.