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

 // Class for opening and manipulating the internet uri list.

 // 

 //

 /**

  @file

  @publishedAll

  @released

 */

 #ifndef __INETURILIST_H__

 #define __INETURILIST_H__

 #include <ineturilistdef.h>

 #include <ineturi.h>

 #include <uri8.h>

 #include <babitflags.h>

 class CInetUriListImpl;

 /**

 This class defines the interface that can be implemented by an application to receive the

 query results. 

 @publishedAll

 @released

 */

 class MQueryResultsCallback

 	{

 	public:

 	/**

 	The callback function that will be called when there is at least one query result.

 	@param aUri The Inet URI object. Ownership will be passed. The application should close the 

 				object handle.

 	@return ETrue - More query results, if any, should follow.

 			EFalse - No more query result is required and querying will be stopped.

 	*/

 	virtual TBool OnQueryResultsL ( RInetUri aUri ) =0;

 	};

 /**

 This class defines the interface that can be implemented by an application that wishes to do

 protocol and scheme-based normalisation of the URI before query operation.

 @publishedAll

 @released

 */

 class MUriCustomiser

 	{

 	public:

 	/**

 	The callback function that will be called to perform scheme and protocol-based normalisation.

 	The URI will be syntax normalised before calling this function.

 	@param aUri The syntax normalised URI.

 	@return Final normalised URI, which is syntax and protocol/scheme based.

 	*/

 	virtual CUri8* OnUriCustomisationL ( const TUriC8& aUri ) =0;	

 	};

 /**

 RInetUriList represents a handle to the list as a whole. Opening the handle will initiate a connection the

 URI List server. This class is responsible for adding, removing, updating, or retrieving the URI and

 its associated properties.

 @publishedAll

 @released

 */

 class RInetUriList

 	{

 public:

 	IMPORT_C RInetUriList ();

 	IMPORT_C void OpenL ();

 	IMPORT_C void Close ();

 	IMPORT_C void AddL ( const RInetUri& aInetUri );

 	IMPORT_C void RemoveL ( const RInetUri& aInetUri );

 	IMPORT_C void UpdateL ( const RInetUri& aInetUri );

 	IMPORT_C RInetUri OpenInetUriL ( const TDesC8& aUri, InetUriList::TServiceType aServiceType );

 	IMPORT_C TInt Count ( InetUriList::TServiceType aServiceType, InetUriList::TListType aListType );

 	IMPORT_C TInt GetListType ( const TDesC8& aUri, InetUriList::TServiceType aServiceType, InetUriList::TListType& aListType );

 	IMPORT_C void QueryUriL ( const TQueryArgs& aArgs, MQueryResultsCallback* aQueryCallback, MUriCustomiser* aUriOptimiser =NULL );

 private:

 	CInetUriListImpl* iInetUriListImpl; // // The internal list object that this handle is connected to

 	};

 #endif //__INETURILIST_H__