FCL/sf/os/persistentdata: comparison persistentstorage/store/INC/S32FILE.INL

equal deleted inserted replaced

-:63532cdadd44
+:0d6db0a14001
 file store object.
 @param aFs Handle to a file server session.
 @param aName The full path name of the file containing the store.
 @param aFileMode The mode in which the file is to be accessed. The mode is
-defined by the TFileMode type. It is strongly recommended to set EFileWriteDirectIO
+defined by the TFileMode type.
-bit. It is because that When the file cache in file server is on, the
-order of file writing is not guaranteed which could cause data inconsistency in some
-circumstances, for example, when the power is lost in the middle of data transaction.
-Therefore, the file write cache should be switched off to maintain the file integrity.
 @return A pointer to the new permanent file store object.
 @see TFileMode */
-	{return STATIC_CAST(CPermanentFileStore*,CFileStore::OpenL(aFs,aName,aFileMode,KPermanentFileStoreFactoryFunction));}
+	{
+//  When the file server write caching is enabled, the order of file write operations is not guaranteed. This could cause data inconsistency in some circumstances,
+//  for example, when the power is lost in the middle of a database transaction. Therefore, the file write caching is disabled for this file to maintain integrity.
+	return STATIC_CAST(CPermanentFileStore*,CFileStore::OpenL(aFs,aName,aFileMode|EFileWriteDirectIO,KPermanentFileStoreFactoryFunction));
+	}
 inline CPermanentFileStore* CPermanentFileStore::OpenLC(RFs& aFs,const TDesC& aName,TUint aFileMode)
 /** Opens a file containing a permanent file store, constructs a permanent file
 store object, and places the pointer onto the cleanup stack.
 @param aFs Handle to a file server session.
 @param aName The full path name of the file containing the store.
 @param aFileMode The mode in which the file is to be accessed. The mode is
-defined by the TFileMode type. It is strongly recommended to set EFileWriteDirectIO
+defined by the TFileMode type.
-bit. It is because that When the file cache in file server is on, the
-order of file writing is not guaranteed which could cause data inconsistency in some
-circumstances, for example, when the power is lost in the middle of data transaction.
-Therefore, the file write cache should be switched off to maintain the file integrity.
 @return A pointer to the new permanent file store object.
 @see TFileMode */
-	{return STATIC_CAST(CPermanentFileStore*,CFileStore::OpenLC(aFs,aName,aFileMode,KPermanentFileStoreFactoryFunction));}
+	{
+//  When the file server write caching is enabled, the order of file write operations is not guaranteed. This could cause data inconsistency in some circumstances,
+//  for example, when the power is lost in the middle of a database transaction. Therefore, the file write caching is disabled for this file to maintain integrity.
+	return STATIC_CAST(CPermanentFileStore*,CFileStore::OpenLC(aFs,aName,aFileMode|EFileWriteDirectIO,KPermanentFileStoreFactoryFunction));
+	}
 inline CPermanentFileStore* CPermanentFileStore::CreateL(RFs& aFs,const TDesC& aName,TUint aFileMode)
 /** Creates a new file and constructs a new permanent file store object to be associated
 with this file.
 @param aFs Handle to a file server session.
 @param aName The full path name of the new file. A file with this name must
 not already exist, otherwise the function leaves.
 @param aFileMode The mode in which the new file is to be accessed. This mode
-is defined by the TFileMode type. It is strongly recommended to set EFileWriteDirectIO
+is defined by the TFileMode type.
-bit. It is because that When the file cache in file server is on, the
-order of file writing is not guaranteed which could cause data inconsistency in some
-circumstances, for example, when the power is lost in the middle of data transaction.
-Therefore, the file write cache should be switched off to maintain the file integrity.
 @return A pointer to the new permanent file store object.
 @see TFileMode */
-	{return STATIC_CAST(CPermanentFileStore*,CFileStore::CreateL(aFs,aName,aFileMode,&DoNewL));}
+	{
+//  When the file server write caching is enabled, the order of file write operations is not guaranteed. This could cause data inconsistency in some circumstances,
+//  for example, when the power is lost in the middle of a database transaction. Therefore, the file write caching is disabled for this file to maintain integrity.
+	return STATIC_CAST(CPermanentFileStore*,CFileStore::CreateL(aFs,aName,aFileMode|EFileWriteDirectIO,&DoNewL));
+	}
 inline CPermanentFileStore* CPermanentFileStore::CreateLC(RFs& aFs,const TDesC& aName,TUint aFileMode)
 /** 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.
 @param aFs Handle to a file server session.
 @param aName The full path name of the new file. A file with this name must
 not already exist, otherwise the function leaves.
 @param aFileMode The mode in which the new file is to be accessed. This mode
-is defined by the TFileMode type. It is strongly recommended to set EFileWriteDirectIO
+is defined by the TFileMode type.
-bit. It is because that when the file cache in file server is on, the
-order of file writing is not guaranteed which could cause data inconsistency in some
-circumstances, for example, when the power is lost in the middle of data transaction.
-Therefore, the file write cache should be switched off to maintain the file integrity.
 @return A pointer to the new permanent file store object.
 @see TFileMode */
-	{return STATIC_CAST(CPermanentFileStore*,CFileStore::CreateLC(aFs,aName,aFileMode,&DoNewL));}
+	{
+//  When the file server write caching is enabled, the order of file write operations is not guaranteed. This could cause data inconsistency in some circumstances,
+//  for example, when the power is lost in the middle of a database transaction. Therefore, the file write caching is disabled for this file to maintain integrity.
+	return STATIC_CAST(CPermanentFileStore*,CFileStore::CreateLC(aFs,aName,aFileMode|EFileWriteDirectIO,&DoNewL));
+	}
 inline CPermanentFileStore* CPermanentFileStore::ReplaceL(RFs& aFs,const TDesC& aName,TUint aFileMode)
 /** Creates a file, constructs a permanent file store object to be associated with
 it.
 This file replaces any existing file of the same name.
 @param aFs Handle to a file server session.
 @param aName The full path name of the file to be replaced.
 @param aFileMode The mode in which the file is to be accessed. The mode is
-defined by the TFileMode type. It is strongly recommended to set EFileWriteDirectIO
+defined by the TFileMode type.
-bit. It is because that when the file cache in file server is on, the
-order of file writing is not guaranteed which could cause data inconsistency in some
-circumstances, for example, when the power is lost in the middle of data transaction.
-Therefore, the file write cache should be switched off to maintain the file integrity.
 @return A pointer to the new permanent file store object.
 @see TFileMode */
-	{return STATIC_CAST(CPermanentFileStore*,CFileStore::ReplaceL(aFs,aName,aFileMode,&DoNewL));}
+	{
+//  When the file server write caching is enabled, the order of file write operations is not guaranteed. This could cause data inconsistency in some circumstances,
+//  for example, when the power is lost in the middle of a database transaction. Therefore, the file write caching is disabled for this file to maintain integrity.
+	return STATIC_CAST(CPermanentFileStore*,CFileStore::ReplaceL(aFs,aName,aFileMode|EFileWriteDirectIO,&DoNewL));
+	}
 inline CPermanentFileStore* CPermanentFileStore::ReplaceLC(RFs& aFs,const TDesC& aName,TUint aFileMode)
 /** 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.
 @param aFs Handle to a file server session.
 @param aName The full path name of the file to be replaced.
 @param aFileMode The mode in which the file is to be accessed. The mode is
-defined by the TFileMode type. It is strongly recommended to set EFileWriteDirectIO
+defined by the TFileMode type.
-bit. It is because that when the file cache in file server is on, the
-order of file writing is not guaranteed which could cause data inconsistency in some
-circumstances, for example, when the power is lost in the middle of data transaction.
-Therefore, the file write cache should be switched off to maintain the file integrity.
 @return A pointer to the new permanent file store object.
 @see TFileMode */
-	{return STATIC_CAST(CPermanentFileStore*,CFileStore::ReplaceLC(aFs,aName,aFileMode,&DoNewL));}
+	{
+//  When the file server write caching is enabled, the order of file write operations is not guaranteed. This could cause data inconsistency in some circumstances,
+//  for example, when the power is lost in the middle of a database transaction. Therefore, the file write caching is disabled for this file to maintain integrity.
+	return STATIC_CAST(CPermanentFileStore*,CFileStore::ReplaceLC(aFs,aName,aFileMode|EFileWriteDirectIO,&DoNewL));
+	}
 inline CPermanentFileStore* CPermanentFileStore::TempL(RFs& aFs,const TDesC& aPath,TFileName& aName,TUint aFileMode)
 /** 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
 @param aName On return, contains the full path name of the new file.
 @param aFileMode The mode in which the file is to be accessed. The mode is
 defined by the TFileMode type.
 @return A pointer to the new permanent file store object.
 @see TFileMode */
-	{return STATIC_CAST(CPermanentFileStore*,CFileStore::TempL(aFs,aPath,aName,aFileMode,&DoNewL));}
+	{
+//  When the file server write caching is enabled, the order of file write operations is not guaranteed. This could cause data inconsistency in some circumstances,
+//  for example, when the power is lost in the middle of a database transaction. Therefore, the file write caching is disabled for this file to maintain integrity.
+	return STATIC_CAST(CPermanentFileStore*,CFileStore::TempL(aFs,aPath,aName,aFileMode|EFileWriteDirectIO,&DoNewL));
+	}
 inline CPermanentFileStore* CPermanentFileStore::TempLC(RFs& aFs,const TDesC& aPath,TFileName& aName,TUint aFileMode)
 /** 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
 @param aFs Handle to a file server session.
 @param aPath The path where the new file is to be created.
 @param aName On return, contains the full path name of the new file.
 @param aFileMode The mode in which the file is to be accessed. The mode is
-defined by the TFileMode type. It is strongly recommended to set EFileWriteDirectIO
+defined by the TFileMode type.
-bit. It is because that When the file cache in file server is on, the
-order of file writing is not guaranteed which could cause data inconsistency in some
-circumstances, for example, when the power is lost in the middle of data transaction.
-Therefore, the file write cache should be switched off to maintain the file integrity.
 @return A pointer to the new permanent file store object.
 @see TFileMode */
-	{return STATIC_CAST(CPermanentFileStore*,CFileStore::TempLC(aFs,aPath,aName,aFileMode,&DoNewL));}
+	{
+//  When the file server write caching is enabled, the order of file write operations is not guaranteed. This could cause data inconsistency in some circumstances,
+//  for example, when the power is lost in the middle of a database transaction. Therefore, the file write caching is disabled for this file to maintain integrity.
+	return STATIC_CAST(CPermanentFileStore*,CFileStore::TempLC(aFs,aPath,aName,aFileMode|EFileWriteDirectIO,&DoNewL));
+	}
 inline CPermanentFileStore* CPermanentFileStore::FromL(RFile& aFile)
 /** Constructs a permanent file store object from an already opened file. It is strongly recommended to set EFileWriteDirectIO
-bit when opening the file. It is because that when the file cache in file server is on, the
+bit when opening the file. This is because that when the file server write caching is enabled, the
-order of file writing is not guaranteed which could cause data inconsistency in some
+order of file write operations is not guaranteed. This could cause data inconsistency in some
-circumstances, for example, when the power is lost in the middle of data transaction.
+circumstances, for example, when the power is lost in the middle of database transaction.
-Therefore, the file write cache should be switched off to maintain the file integrity.
+Therefore, the file write caching should be switched off to maintain integrity.
 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.
 inline CPermanentFileStore* CPermanentFileStore::FromLC(RFile& aFile)
 /** 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. It is strongly recommended to set EFileWriteDirectIO
-bit when opening the file. It is because that when the file cache in file server is on, the
+bit when opening the file. This is because that when the file server write caching is enabled, the
-order of file writing is not guaranteed which could cause data inconsistency in some
+order of file write operations is not guaranteed. This could cause data inconsistency in some
-circumstances, for example, when the power is lost in the middle of data transaction.
+circumstances, for example, when the power is lost in the middle of database transaction.
-Therefore, the file write cache should be switched off to maintain the file integrity.
+Therefore, the file write caching should be switched off to maintain integrity.
 Note that ownership of the file passes to the store. The referenced RFile
 is cleared and is no longer valid.
 @param aFile A reference to the opened file.
 inline CPermanentFileStore* CPermanentFileStore::NewL(RFile& aFile)
 /** 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. It is strongly recommended to set EFileWriteDirectIO
-bit when opening the file. It is because that when the file cache in file server is on, the
+bit when opening the file. It is because that when the file write caching in file server is on, the
 order of file writing is not guaranteed which could cause data inconsistency in some
 circumstances, for example, when the power is lost in the middle of data transaction.
-Therefore, the file write cache should be switched off to maintain the file integrity.
+Therefore, the file write caching should be switched off to maintain the file integrity.
 Note that ownership of the file passes to the store. The referenced RFile
 is cleared and is no longer valid.
 @param aFile A reference to the opened file.
 /** 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. It is strongly recommended to set EFileWriteDirectIO
-bit when opening the file. It is because that when the file cache in file server is on, the
+bit when opening the file. It is because that when the write caching in file server is on, the
 order of file writing is not guaranteed which could cause data inconsistency in some
 circumstances, for example, when the power is lost in the middle of data transaction.
-Therefore, the file write cache should be switched off to maintain the file integrity.
+Therefore, the file write caching should be switched off to maintain the file integrity.
 Note that ownership of the file passes to the store. The referenced RFile
 is cleared and is no longer valid.
 @param aFile A reference to the opened file.

changeset 35	0d6db0a14001
parent 25	63532cdadd44
child 40	b8bdbc8f59c7