/*

* Copyright (c) 2002 Nokia Corporation and/or its subsidiary(-ies). 

* All rights reserved.

* This component and the accompanying materials are made available

* under the terms of "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:  it is used to update session slot state and signal new

*				 session slot events

*

*/

#ifndef __RPENGSTORAGEADMINSUBCLIENT_H__

#define __RPENGSTORAGEADMINSUBCLIENT_H__

//  INCLUDES

#include <e32def.h>

#include "PEngStorageGlobals.h"

// FORWARD DECLARATIONS

class RPEngStorageAdminClient;

/**

 *  Storage Admin sub-client

 *  it is used to update session slot state and

 *  signal new session slot events

 *

 *  @lib PEngStoreMan2.dll

 *  @since 3.0

 */

// CLASS DECLARATION

class  RPEngStorageAdminSubClient: public RSubSessionBase

    {

    public:		// Constructors and destructors

        /**

         * C++ default constructor.

         */

        IMPORT_C RPEngStorageAdminSubClient( );

        /**

         * Destructor.

         */

        IMPORT_C ~RPEngStorageAdminSubClient( void );

    public: 	// new methods

        /**

         *  Connects to the presence server

         *

         *	@since 3.0

         *	@param aAdminClient main admin client

         *	@param aSessionName packed session slot Id

         *	@return KErrNone or any of system wide error codes

         */

        IMPORT_C TInt Connect(

            RPEngStorageAdminClient& aAdminClient,

            const TDesC8& aSesssionName );

        /**

         *	Close connection to the presence server

         *	When this sub-session is closed it is assumed that

         *  State of the connection is closed

         *

         *	@since 3.0

         */

        IMPORT_C void Close();

    public:		// new Storage management Functions

        /**

         *	Update Presence State of defined connection.

         *

         *	@since 3.0

         *  @param aState state of the Session Slot, in case

         *				aEven is not reconstructed, this value

         *				is used instead to determine state of the

         *				session

         *	@param aEvent new event of session slot from the Presence Server

         *	@return KErrNone if notification went OK,

         *					otherwise system wide error code

         */

        IMPORT_C TInt NotifyEvent( const TDesC8& aEvent );

        /**

         *  Notify error from to the listeners

         *

         *  @since 3.0

         *  @param aError code to be notified to listeners

         */

        IMPORT_C TInt NotifyError( TInt aError );

        /**

         *	Check if Application Id is registered for given session slot

         *

         *  @since 3.0

         *	@param aAppId application Id

         *  @return KErrNone if registered, KErrNotFound if not

         *			system wide error code if something other goes wrong

         */

        IMPORT_C TInt CheckAppIdRegistration( const TDesC& aAppId );

    private:	// Data

        /// Flag if sub Session is connected to the Server

        TBool										iConnected;

    };

#endif      //  __RPENGSTORAGEADMINSUBCLIENT_H__