Class CDictionaryFileStore

CDictionaryFileStore

Support

Supported from 5.0

Description

File based dictionary store.

A dictionary store is a store where a stream is accessed by UID, rather than directly by stream ID. A dictionary store contains streams in the usual way but, in addition, the root stream is a stream dictionary, i.e. a CStreamDictionary type.

Derivation

CBase Base class for all classes to be instantiated on the heap CDictionaryFileStore File based dictionary store CDictionaryStore Dictionary store interface

Defined in CDictionaryFileStore:
OpenL(), OpenLC(), SystemL(), SystemLC()

Inherited from CBase:
operator new()

Inherited from CDictionaryStore:
Commit(), CommitL(), IsNullL(), IsPresentL(), Remove(), RemoveL(), Revert(), RevertL()

static CDictionaryFileStore* OpenL(RFs& aFs,const TDesC& aName,TUid aUid3);

Description

Creates a file based dictionary store object.

If the file with the specified full path name exists, then an attempt is made to open an existing file store contained within this file. Any existing file store must satisfy the following conditions:

• it must be a valid dictionary store

• the third UID component of the file store type must match the specified UID; this UID serves to differentiate between dictionary stores

otherwise the function leaves with KErrCorrupt.

If the file with the specified full path name does not exist, then an attempt is made to create a new file and to create a file based dictionary within it. The third UID component of the file store type is set to the specified UID value.

Note that the file is opened in exclusive access mode.

Parameters

RFs& aFs Handle to a file server session. const TDesC& aName The full path name of the file. TUid aUid3 The UID used to differentiate between dictionary stores.

Return value

CDictionaryFileStore* A pointer to the file based dictionary store object.

See also:

• TUid
• TUidType

static CDictionaryFileStore* OpenLC(RFs& aFs,const TDesC& aName,TUid aUid3);

Description

Creates a file based dictionary store object and puts the pointer onto the cleanup stack.

If the file with the specified full path name exists, then an attempt is made to open an existing file store contained within this file. Any existing file store must satisfy the following conditions:

• it must be a valid dictionary store

• the third UID component of the file store type must match the specified UID; this UID serves to differentiate between dictionary stores

otherwise the function leaves with KErrCorrupt.

If the file with the specified full path name does not exist, then an attempt is made to create a new file and to create a file based dictionary within it. The third UID component of the file store type is set to the specified UID value.

Note that the file is opened in exclusive access mode.

Parameters

RFs& aFs Handle to a file server session. const TDesC& aName The full path name of the file. TUid aUid3 The UID used to differentiate between dictionary stores.

Return value

CDictionaryFileStore* A pointer to the file based dictionary store object.

See also:

• TUid
• TUidType

static CDictionaryFileStore* SystemL(RFs& aFs);

Description

Opens the system dictionary file store.

Parameters

RFs& aFs Handle to a file server session.

Return value

CDictionaryFileStore* A pointer to the system file based dictionary store object.

static CDictionaryFileStore* SystemLC(RFs& aFs);

Description

Opens the system dictionary file store and puts the pointer to the file store object onto the cleanup stack.

Parameters

RFs& aFs Handle to a file server session.

Return value

CDictionaryFileStore* A pointer to the system file based dictionary store object.