/*
* Copyright (c) 2002-2010 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:  Define SRCS's transport ECom interface.
*
*/



#ifndef _SRCSTRANSPORT_
#define _SRCSTRANSPORT_

//  INCLUDES
#include <e32base.h>
#include <ecom.h>
#include <badesca.h>
#include <obex.h>
#include "SrcsClSv.h"

// CONSTANTS
// UID of this interface
const TUid KCSrcsTransportUid = {0x101F7C9A};

// default OBEX receiving buffer size, 
// used when service controller does not specify the receiving buffer size in its .rss
const TUint KSRCSDefaultReceiveMtu = 0x4000;

// default OBEX sending buffer size, 
// used when service controller does not specify the sending buffer size in its .rss
const TUint KSRCSDefaultTransmitMtu = 0x3000;

 
 

/**
 *	An abstract class being representative of the
 *	concrete class which the client wishes to use.
 *	It acts as a base, for a real class to provide all the
 *	functionality that a client requires.
 *	It supplies instantiation & destruction by using
 *	the ECom framework, and functional services
 *	by using the methods of the actual class.
 */
class CSrcsTransport : public CBase, public MObexAuthChallengeHandler
    {
public:

   /**
    * Two-phased constructor.
    */
    static CSrcsTransport* NewL(TUid aImplUid, CImplementationInformation* aParams );

   /**
    * Destructor.
    */
    virtual ~CSrcsTransport();

   /** 
	* Request a list of all available implementations which satisfies this given interface.
	*
    * @param aImplInfoArray Implementation instance array.
    * @return none.
	*/
    static void ListAllImplementationsL(RImplInfoPtrArray& aImplInfoArray);

   /** 
	* Request a list of matching implementations which satisfies this given interface.
	*
    * @param aMatchString	String to be matched by the implemention.
    * @param aImplInfoArray Implementation instance array.
    * @return none.
	*/
    static void ListImplementationsL(const TDesC8& aMatchString, RImplInfoPtrArray& aImplInfoArray);

   /** 
	* Check if OBEX service is still active.
	*
    * @return true: OBEX service is still active.
	*		  false: OBEX service is inactive.
	*/
	virtual TBool IsOBEXActive() = 0;
    
	/** 
    * Perform any outstanding initialization tasks.
    * 
    * The transport may decide to implement two-phase initialization to improve performance where needed.
    * For instance, USB Transport has to register all service controller's interfaces and complete the message from obex class controller
    * as soon as possible to satisfy timing requirements and defer service controller plugin creation to later stage.
    *
    * @return none.
    */
    virtual void PostInitializeL();
	

protected:
   /**
    * C++ default Constructor
    */
    inline CSrcsTransport();

   /**
    * MObexAuthChallengeHandler implementation
    */

   /**
    * Password for authenticated connection
    *
    * @param aUserID	user id.
    */
    virtual void GetUserPasswordL( const TDesC& aUserID ) = 0;


private:
    // Unique instance identifier key
    TUid iDtor_ID_Key;
    };

#include "SrcsTransport.inl"

#endif