Class CSecureStore

CSecureStore

Support

Supported from 5.0

Description

A stream store whose streams are encrypted.

The secure store is layered over another stream store which acts as the host for the encrypted streams. This stream store is not owned by the secure store, which means that it is possible to to use the secure store to store only a portion of the streams in encrypted form.

Access to the streams in this store is via the normal RStoreWriteStream and RStoreReadStream classes. Internally, TEncryptFilter and TDecryptFilter objects are attached to the streams from the host store in order to do the encryption and decryption.

Derivation

CBase Base class for all classes to be instantiated on the heap CSecureStore A stream store whose streams are encrypted CStreamStore Provides the core abstract framework for stores allowing streams to be created and manipulated

Defined in CSecureStore:
CSecureStore(), NewL(), NewLC()

Inherited from CBase:
operator new()

Inherited from CStreamStore:
Commit(), CommitL(), CompactL(), Delete(), DeleteL(), DoCommitL(), DoCompactL(), DoCreateL(), DoDeleteL(), DoReadL(), DoReclaimL(), DoReplaceL(), DoRevertL(), DoWriteL(), ExtendL(), ReclaimL(), Revert(), RevertL()

See also:

• RStoreWriteStream
• RStoreReadStream
• TEncryptFilter
• TDecryptFilter

static CSecureStore* NewL(CStreamStore& aHost,const CSecurityBase& aKey);
    

Description

Allocates, constructs and returns a pointer to a new secure store object.

Parameters

CStreamStore& aHost The stream store acting as host for the secure store's streams. const CSecurityBase& aKey Interface to the security model used to generate decryption and encryption handling objects. Ownership of this object remains with the caller who should delete it when it is no longer needed.

Return value

CSecureStore* A pointer to the new secure store.

Notes:

• The secure store does not take ownership of the host stream store.

static CSecureStore* NewLC(CStreamStore& aHost,const CSecurityBase& aKey);

Description

Allocates, constructs and returns a pointer to a new secure store object, putting the pointer onto the cleanup stack.

Parameters

CStreamStore& aHost The stream store acting as host for the secure store's streams. const CSecurityBase& aKey Interface to the security model used to generate decryption and encryption handling objects. Ownership of this object remains with the caller who should delete it when it is no longer needed.

Return value

CSecureStore* A pointer to the new secure store.

CSecureStore(CStreamStore& aHost,const CSecurityBase& aKey);

Description

Constructor taking a reference to the host stream store and the security model.

Parameters

CStreamStore& aHost The stream store acting as host for the secure store's streams. const CSecurityBase& aKey Interface to the security model used to generate decryption and encryption handling objects. Ownership of this object remains with the caller who should delete it when it is no longer needed.