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); ...
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.
Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License v1.0.