--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/epoc32/include/ineturilist.h Tue Mar 16 16:12:26 2010 +0000
@@ -0,0 +1,113 @@
+// 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__