epoc32/include/http/mhttpfilterbase.h
author William Roberts <williamr@symbian.org>
Tue, 16 Mar 2010 16:12:26 +0000
branchSymbian2
changeset 2 2fe1408b6811
parent 0 061f57f2323e
permissions -rw-r--r--
Final list of Symbian^2 public API header files

// Copyright (c) 2001-2009 Nokia Corporation and/or its subsidiary(-ies).
// All rights reserved.
// This component and the accompanying materials are made available
// under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members
// which accompanies this distribution, and is available
// at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
//
// Initial Contributors:
// Nokia Corporation - initial contribution.
//
// Contributors:
//
// Description:
//



/**
 @file MHTTPFilterBase.h
 @warning : This file contains Rose Model ID comments - please do not delete
*/

#ifndef	__MHTTPFILTERBASE_H__
#define	__MHTTPFILTERBASE_H__ 

// System includes
#include <e32std.h>

// Forward declarations
class RHTTPTransaction;
class THTTPEvent;
class THTTPSessionEvent;


//##ModelId=3A914DF9034F
class MHTTPFilterBase
/** 
A HTTP Filter. This is the base class for normal filters
(MHTTPFilter) which adds an unload function, and
MHTTPTransactionCallback, which doesn't add an unload function.  
@publishedAll
@released
*/
	{
public:
	/** Called when the filter's registration conditions are satisfied for events that
		occur on a transaction. Any Leaves must be handled by the appropriate MHFRunError.
		Note that this function is not allowed to leave if called with
		certain events. @see THTTPEvent
		@param aTransaction The transaction that the event has occurred on.
		@param aEvent The event that has occurred.
	*/
	//##ModelId=3A914DF9035D
	IMPORT_C virtual void MHFRunL(RHTTPTransaction aTransaction, const THTTPEvent& aEvent);

	/** Called when the filters registration conditions are satisfied for events that occur
		on the session. Any leaves must be handled by the appropriate MHFRunError.
		@param aEvent The session event that has occured.
	*/
	//##ModelId=3C4C37D401C1
	IMPORT_C virtual void MHFSessionRunL(const THTTPSessionEvent& aEvent);

	/** Called when RunL leaves from a transaction event. This works in the same
		way as CActve::RunError; return KErrNone if you have handled the error.
		If you don't completely handle the error, a panic will occur.
		@param aError The leave code that RunL left with.
		@param aTransaction The transaction that was being processed.
		@param aEvent The Event that was being processed.
		@return KErrNone if the error has been cancelled or the code
		of the continuing error otherwise.
	*/
	//##ModelId=3A914DF90359
	IMPORT_C virtual TInt MHFRunError(TInt aError, RHTTPTransaction aTransaction, const THTTPEvent& aEvent);

	/** Called when MHFRunL leaves from a session event. This works in the same
		way as CActve::RunError
		If you don't completely handle the error, a panic will occur.
		@param aError The leave code that RunL left with.
		@param aEvent The Event that was being processed.
		@return KErrNone if the error has been cancelled or the code
		of the continuing error otherwise.	
	*/
	//##ModelId=3C4C37D302C4
	IMPORT_C virtual TInt MHFSessionRunError(TInt aError, const THTTPSessionEvent& aEvent);
 	};


#endif //	 __MHTTPFILTERBASE_H__