applayerpluginsandutils/httptransportplugins/httptransporthandler/msocketcontrollerfactory.h
changeset 0 b16258d2340f
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/applayerpluginsandutils/httptransportplugins/httptransporthandler/msocketcontrollerfactory.h	Tue Feb 02 01:09:52 2010 +0200
@@ -0,0 +1,58 @@
+// Copyright (c) 2003-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 __MSOCKETCONTROLLERFACTORY_H__
+#define __MSOCKETCONTROLLERFACTORY_H__
+
+#include <e32std.h>
+
+class CSocket;
+class CSocketController;
+class TInetAddr;
+
+class MSocketControllerFactory
+/**	
+	The MSocketControllerFactory API provides support to create socket controller
+	objects that encapsulate a connected socket. Also provides an API to place 
+	socket controllers in a store.
+	@internalComponent
+*/
+	{
+public:	// methods
+
+/**	
+	Creates a socket controller object to encapsulate the connected socket. 
+	Ownership of the connected socket is transferred to the socket controller. 
+	The pointer to the created object is left on the cleanup stack. 
+	@param		aConnectedSocket	The connected socket.
+	@return		A pointer to the created socket controller object, which has 
+				also been left on the cleanup stack.
+	@panic		EInvariantFalse	The connected socket pointer was NULL
+*/
+	virtual CSocketController* CreateSocketControllerLC(CSocket* aConnectedSocket) =0;
+	
+	virtual CSocketController* CreateSocketControllerLC(CSocket* aConnectedSocket, const TDesC& aRemoteHost, TUint16 aRemotePort, const TInetAddr& aRemoteAddr) =0;
+/**	
+	Requests that the socket controller be added to the socket controller store.
+	Ownership of the socket controller is transferred on calling this function.	
+	@param		aSocketController	The socket controller object to be placed 
+									in the socket controller store.
+	@panic		EInvariantFalse	The socket controller pointer was NULL
+*/
+	virtual void AddToStoreL(CSocketController* aSocketController) =0;
+
+	};
+
+#endif	// __MSOCKETCONTROLLERFACTORY_H__