diff -r 666f914201fb -r 2fe1408b6811 epoc32/include/mw/favouritessession.h --- a/epoc32/include/mw/favouritessession.h Tue Nov 24 13:55:44 2009 +0000 +++ b/epoc32/include/mw/favouritessession.h Tue Mar 16 16:12:26 2010 +0000 @@ -1,1 +1,139 @@ -favouritessession.h +/* +* Copyright (c) 2004 Nokia Corporation and/or its subsidiary(-ies). +* All rights reserved. +* This component and the accompanying materials are made available +* under the terms of the License "Eclipse Public License v1.0" +* which accompanies this distribution, and is available +* at the URL "http://www.eclipse.org/legal/epl-v10.html". +* +* Initial Contributors: +* Nokia Corporation - initial contribution. +* +* Contributors: +* +* Description: Declaration of RFavouritesSession +* +*/ + + +#ifndef FAVOURITES_SESSION_H +#define FAVOURITES_SESSION_H + +// INCLUDES + +#include + +// CLASS DECLARATION + +/** +* RFavouritesSession is the Favourites Engine Session. +* It represents the connection to the Favourites Engine Server. +*/ +class RFavouritesSession : public RSessionBase + { + public: // New methods + + /** + * Get version. + * @since 0.9 + * @return Version. + */ + IMPORT_C static TVersion Version(); + + /** + * Connect to Favourites Server. + * @since 0.9 + * @return Error code. + */ + IMPORT_C TInt Connect(); + + /** + * Start checking the number of allocated object through this session. + * @since 0.9 + * @return void + */ + IMPORT_C void ResourceMark(); + + /** + * Check that the number of allocated object through this session + * matches the same of when the last call to ResourceMark was made. + * @since 0.9 + * @return void + */ + IMPORT_C void ResourceCheck(); + + /** + * Get number of allocated object through this session. + * @since 0.9 + * @return void + */ + IMPORT_C TInt ResourceCount(); + + /** + * Delete database. + * @param aName Database name. + * @since 0.9 + * @return ErrorCode + */ + IMPORT_C TInt DeleteDatabase( const TDesC& aName ); + + /** + * Simulate a heap allocation failure for server heap. Has empty + * implementation for the UDEB server. + * @since 0.9 + * @param aType Type of heap failure simulation. + * @param aRate Rate of failure. + * @return void + */ + IMPORT_C void __DbgSetAllocFail + ( RAllocator::TAllocFail aType, TInt aRate ); + + public: // But not exported + + /** + * Message passing routine. + * @since 0.9 + * @param aFunction Function. + * @param aArgs Arguments. + * @param aStatus Request status. + */ + inline void SendReceive + ( + TInt aFunction, + const TIpcArgs& aArgs, + TRequestStatus& aStatus + ) const; + + /** + * Message passing routine. + * @since 0.9 + * @param aFunction Function. + * @param aArgs Arguments. + * @return Error code. + */ + inline TInt SendReceive( TInt aFunction, const TIpcArgs& aArgs ) const; + + /** + * Message passing routine. + * @since 0.9 + * @param aFunction Function. + * @return Error code. + */ + inline TInt SendReceive( TInt aFunction ) const; + + private: // New methods + + /** + * Connect to Favourites Server. + * @since 0.9 + * @return Error code. + */ + TInt DoConnect(); + + }; + +#endif + +#include + +// End of File