qtmobility/plugins/contacts/symbian/inc/filtering/cntabstractcontactfilter.h
changeset 4 90517678cc4f
parent 1 2b40d63a9c3d
child 11 06b8e2af4411
--- a/qtmobility/plugins/contacts/symbian/inc/filtering/cntabstractcontactfilter.h	Fri Apr 16 15:51:22 2010 +0300
+++ b/qtmobility/plugins/contacts/symbian/inc/filtering/cntabstractcontactfilter.h	Mon May 03 13:18:40 2010 +0300
@@ -53,18 +53,26 @@
 {
 public:
     enum FilterSupport {
-        /* The filter not supported */
+        /* The filter is not supported */
         NotSupported = 0,
-        /* The filter is supported */
+        /* The filter is illegal. Filtering is not allowed and the operation
+         * should fail immediately with an error.
+         */
+        IllegalFilter,
+        /* The filter is supported natively */
         Supported,
-        /* The filter is not directly supported, but for performance reasons
-         * the contact filter implementation pretends supporting the filter
-         * when it actually maps the filter to another, less strict filter.
-         * For example if the caller uses match flag QContactFilter::MatchExactly, the
-         * filter actually gives the result as QContactFilter::MatchContains (because of
-         * the limitations in the underlying database).
+        /* The filter is not fully natively supported, but for performance
+         * reasons the contact filter implementation pretends supporting the
+         * filter when it actually maps the filter to another, less strict
+         * filter.
+         * 
+         * For example if the caller uses match flag QContactFilter::MatchExactly,
+         * the filter actually gives the result as QContactFilter::MatchContains
+         * (because of the limitations in the underlying database).
+         * 
          * The result then needs to be filtered by the caller (for example by
-         * using QContactManagerEngine::testFilter). */
+         * using QContactManagerEngine::testFilter).
+         */
         SupportedPreFilterOnly
     };
 public:
@@ -72,7 +80,7 @@
             const QContactFilter &filter,
             const QList<QContactSortOrder> &sortOrders,
             bool &filterSupported,
-            QContactManager::Error &error) = 0;
+            QContactManager::Error* error) = 0;
     virtual bool filterSupported(const QContactFilter& filter) = 0;
 };