// Copyright (c) 2006-2009 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:

// Initial Contributors:

// Nokia Corporation - initial contribution.

// Contributors:

// Provides an interface to operate with PTP/IP Controller like., Notify the 

// PTP/IP Controller of incoming requests, Stop the existing transport, Set the 

// current Device GUID and Device Friendly Name,Get a new blank socket everytime 

// there is a connection request.

//

/**

 @publishedPartner

 @released

*/

#ifndef __MPTPIPCONTROLLER_H__

#define __MPTPIPCONTROLLER_H__

#include <e32cmn.h>

#include <es_sock.h>

class MPTPIPController

{

	public:

		/*

		Stops the existing PTPIP transport,In-turn closes the client-side session

		with MTP server,Before calling StopTransport(),any outstanding Listen call

		over socket,has to be cancelled.

		*/

		virtual void StopTransport()=0;

	   /*

	   	This method is called to notify the PTP/IP Controller that there is an incoming connection 

	   	request.It hands over the Command or Event Sockets to the appropriate Socket Handlers.

	   	There is a validation happening as to whether both of the above requests are coming

	   	from the same host; it validates if it is from the same host; otherwise rejects the 

	   	request and starts listening on the socket again.

     	@param TRequestStatus of the caller.

	   */

		virtual void SocketAccepted(TRequestStatus& aStatus)=0;

		/*

		Saves the current Device GUID(Globally Unique Identifier)

		@param GUID of the device which is obtained from the Device as a part of InitCommandAck Packet

		@return KErrNone if GUID is valid, otherwise KErrArgument

		*/

		virtual TInt SetDeviceGUID(TDesC8& aDeviceGUID)=0;

		/*

		Saves the current Device Friendly Name

		@param Friendly Name of the device which is obtained from the Device as a part of InitCommandAck Packet

		*/

		virtual void SetDeviceFriendlyName(TDesC16* aDeviceFriendlyName)=0;

		/*

		Issues a new blank socket.NewSocketL() has to be called when a socket is required to accept

		the incoming connection request.

		@return Reference to the socket the PTPIP/Controller owns.

		@leave when it cannot return any more sockets.It leaves when there are more than 3 connection requests

		per session

		*/

		virtual RSocket& NewSocketL()=0;

};

#endif