CPermanentFileStore Class Reference

aFile

)

Parameters

RFile & aFile

CPermanentFileStore(RFileBuf &, const TUidType &)

IMPORT_C	CPermanentFileStore	(	RFileBuf &	aBuf,
			const TUidType &	aType
		)

Parameters

RFileBuf & aBuf
const TUidType & aType

~CPermanentFileStore()

IMPORT_C

~CPermanentFileStore

(

)

Member Functions Documentation

Coord()

CPermanentStoreCoord &

Coord

(

)

const [private, inline]

CoordL()

CPermanentStoreCoord &

CoordL

(

)

const [private]

CreateL(RFs &, const TDesC &, TUint)

CPermanentFileStore *	CreateL	(	RFs &	aFs,
			const TDesC &	aName,
			TUint	aFileMode
		)	[static, inline]

Creates a new file and constructs a new permanent file store object to be associated with this file.

A pointer to the new permanent file store object.

Parameters

RFs & aFs	Handle to a file server session.
const TDesC & aName	The full path name of the new file. A file with this name must not already exist, otherwise the function leaves.
TUint aFileMode	The mode in which the new file is to be accessed. This mode is defined by the TFileMode type.

CreateLC(RFs &, const TDesC &, TUint)

CPermanentFileStore *	CreateLC	(	RFs &	aFs,
			const TDesC &	aName,
			TUint	aFileMode
		)	[static, inline]

Creates a new file and constructs a new permanent file store object to be associated with this file, and places the pointer onto the cleanup stack.

A pointer to the new permanent file store object.

RStoreReadStream::OpenL()

Parameters

RFs & aFs	Handle to a file server session.
const TDesC & aName	The full path name of the new file. A file with this name must not already exist, otherwise the function leaves.
TUint aFileMode	The mode in which the new file is to be accessed. This mode is defined by the TFileMode type.

DoCommitL()

IMPORT_C void

DoCommitL

(

)

[private, virtual]

DoCompactL()

IMPORT_C MIncrementalCollector *

DoCompactL

(

)

[private, virtual]

DoCreateL(TStreamId &)

IMPORT_C MStreamBuf *

DoCreateL

(

TStreamId &

anId

)

[protected, virtual]

Creates a new stream in the store. The function gets the allocated stream id in the anId parameter. A stream buffer for the stream should be returned, ready to write into the new stream. This provides the implementation for the RStoreWriteStream::CreateL() functions.

The stream buffer to be written to.

Parameters

TStreamId & anId

On return, contains the allocated stream id.

DoDeleteL(TStreamId)

IMPORT_C void

DoDeleteL

IMPORT_C MStreamBuf *

DoReadL

(

TStreamId

anId

)

const [protected, virtual]

Opens the requested stream for reading. The function should return a stream buffer positioned at the beginning of this stream.

This function is called by the OpenL() and OpenLC() member functions of RStoreReadStream.

A stream buffer positioned at the beginning of the stream to be read.

RStoreReadStream::OpenLC()

Parameters

TStreamId anId

[protected, virtual]

Parameters

TStreamId anId

ExternalizeL(RWriteStream &)

IMPORT_C void

ExternalizeL

(

RWriteStream &

aStream

)

const [private, virtual]

Parameters

RWriteStream & aStream

FromL(RFile &)

FromL

(

aFile

)

[static, inline]

Constructs a permanent file store object from an already opened file.

The file must already be open before calling this function.

Note that ownership of the file passes to the store. The referenced RFile is cleared and is no longer valid.

A pointer to the new permanent file store object.

Parameters

RFile & aFile

A reference to the opened file.

FromLC(RFile &)

FromLC

(

KDirectFileStoreLayoutUid

aFile

)

[static, inline]

Constructs a permanent file store object from an already opened file, and places the pointer onto the cleanup stack.

The file must already be open before calling this function.

Note that ownership of the file passes to the store. The referenced RFile is cleared and is no longer valid.

A pointer to the new permanent file store object.

Parameters

RFile & aFile

A reference to the opened file.

InternalizeL(RReadStream &)

IMPORT_C void

InternalizeL

(

RReadStream &

aStream

)

[private, virtual]

Parameters

RReadStream & aStream

Layout()

IMPORT_C TUid

Layout

(

)

const [virtual]

Gets the UID that uniquely identifies the specific type of this file store.

This function must be defined and implemented by classes derived from CFileStore. The direct file store, CDirectFileStore and the permanent file store, CPermanentFileStore both implement suitable functions.

The UID that uniquely identifies the specific type of file store.

KPermanentFileStoreLayoutUid

MarshalL()

IMPORT_C void

MarshalL

(

)

NewL(RFile &)

NewL

(

aFile

)

[static, inline]

Constructs a new permanent file store object in an already opened file.

The file must already be open before calling this function. The existing content of the file is discarded.

Note that ownership of the file passes to the store. The referenced RFile is cleared and is no longer valid.

A pointer to the new permanent file store object.

Parameters

RFile & aFile

A reference to the opened file.

NewLC(RFile &)

NewLC

(

aFile

)

[static, inline]

Constructs a new permanent file store object in an already opened file and places the pointer onto the cleanup stack.

The file must already be open before calling this function.The existing content of the file is discarded.

Note that ownership of the file passes to the store. The referenced RFile is cleared and is no longer valid.

A pointer to the new permanent file store object.

Parameters

RFile & aFile

A reference to the opened file.

OpenL(RFs &, const TDesC &, TUint)

CPermanentFileStore *	OpenL	(	RFs &	aFs,
			const TDesC &	aName,
			TUint	aFileMode
		)	[static, inline]

Opens a file containing a permanent file store, and constructs a permanent file store object.

A pointer to the new permanent file store object.

Parameters

RFs & aFs	Handle to a file server session.
const TDesC & aName	The full path name of the file containing the store.
TUint aFileMode	The mode in which the file is to be accessed. The mode is defined by the TFileMode type.

OpenLC(RFs &, const TDesC &, TUint)

CPermanentFileStore *	OpenLC	(	RFs &	aFs,
			const TDesC &	aName,
			TUint	aFileMode
		)	[static, inline]

Opens a file containing a permanent file store, constructs a permanent file store object, and places the pointer onto the cleanup stack.

A pointer to the new permanent file store object.

Parameters

RFs & aFs	Handle to a file server session.
const TDesC & aName	The full path name of the file containing the store.
TUint aFileMode	The mode in which the file is to be accessed. The mode is defined by the TFileMode type.

ReplaceL(RFs &, const TDesC &, TUint)

CPermanentFileStore *	ReplaceL	(	RFs &	aFs,
			const TDesC &	aName,
			TUint	aFileMode
		)	[static, inline]

Creates a file, constructs a permanent file store object to be associated with it.

This file replaces any existing file of the same name.

A pointer to the new permanent file store object.

Parameters

RFs & aFs	Handle to a file server session.
const TDesC & aName	The full path name of the file to be replaced.
TUint aFileMode	The mode in which the file is to be accessed. The mode is defined by the TFileMode type.

ReplaceLC(RFs &, const TDesC &, TUint)

CPermanentFileStore *	ReplaceLC	(	RFs &	aFs,
			const TDesC &	aName,
			TUint	aFileMode
		)	[static, inline]

Creates a file, constructs a permanent file store object to be associated with it, and places the pointer onto the cleanup stack.

This file replaces any existing file of the same name.

A pointer to the new permanent file store object.

Parameters

RFs & aFs	Handle to a file server session.
const TDesC & aName	The full path name of the file to be replaced.
TUint aFileMode	The mode in which the file is to be accessed. The mode is defined by the TFileMode type.

TempL(RFs &, const TDesC &, TFileName &, TUint)

CPermanentFileStore *	TempL	(	RFs &	aFs,
			const TDesC &	aPath,
			TFileName &	aName,
			TUint	aFileMode
		)	[static, inline]

Creates a temporary file and constructs a permanent file store object to be associated with it.

The new file is created in the specified path and a unique file name is generated by the file server.

Note that the store framework does not delete a temporary file after it is closed.

A pointer to the new permanent file store object.

Parameters

RFs & aFs	Handle to a file server session.
const TDesC & aPath	The path where the new file is to be created.
TFileName & aName	On return, contains the full path name of the new file.
TUint aFileMode	The mode in which the file is to be accessed. The mode is defined by the TFileMode type.

TempLC(RFs &, const TDesC &, TFileName &, TUint)

CPermanentFileStore *	TempLC	(	RFs &	aFs,
			const TDesC &	aPath,
			TFileName &	aName,
			TUint	aFileMode
		)	[static, inline]

Creates a temporary file, constructs a permanent file store object to be associated with it, and places the pointer onto the cleanup stack.

The new file is created in the specified path and a unique file name is generated by the file server.

Note that the store framework does not delete a temporary file after it is closed.

A pointer to the new permanent file store object.