// 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:

//

#ifndef __MSOCKETCONNECTOR_H__

#define __MSOCKETCONNECTOR_H__

#include <e32std.h>

/**

The MSocketConnector class provides an API to control a socket connection

request. The socket connection would have been requested via the 

MSocketFactory API. An observer is required for the socket connection - a

MSocketConnectObserver object.

The MSocketConnector can stop the connection only if the socket connect

observer has not notified of either a successful connection or that an error

has occurred.

If the connection is stopped then the observer will receive no notification

and the MSocketConnector object is no longer valid.

@see MSocketFactory

@see MSocketConnectObserver	

@internalTechnology

@prototype

*/

class MSocketConnector

	{

public:

	/**

	Stops the connect service. The connect service can only be stopped if the

	connection has not been established - i.e. before the appropriate 

	MSocketConnectObserver object has been called ConnectionMadeL() API. The

	connect observer will be notified on the MSocketConnectObserver::HandleConnectError()

	API with an error code of KErrCancel when the connect service has actually

	stopped.

	@pre The socket connect observer has not been notified.

	@post The socket connector is no longer valid.

	*/

	virtual void StopConnect() =0;

	};

#endif	// __MSOCKETCONNECTOR_H__