ncdengine/inc/catalogsengineobserver.h
changeset 0 ba25891c3a9e
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/ncdengine/inc/catalogsengineobserver.h	Thu Dec 17 08:51:10 2009 +0200
@@ -0,0 +1,73 @@
+/*
+* Copyright (c) 2006 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:   Catalogs Engine callback interface definition
+*
+*/
+	
+
+#ifndef M_CATALOGS_ENGINE_OBSERVER_H
+#define M_CATALOGS_ENGINE_OBSERVER_H
+
+#include <e32cmn.h>
+
+/**
+ * Observer interface for catalogs engine events
+ *
+ * Engine users should implement this interface to be able to receive
+ * notifications from the catalogs engine
+ *
+ * 
+ */
+class MCatalogsEngineObserver
+    {
+    
+public:
+
+    /**
+     * Called when the Catalogs Engine is about to be updated. The client
+     * must stop using the Engine, closing its session(s) and deleting its
+     * Catalogs Engine objects ASAP.
+     */
+    virtual void CatalogsEngineShutdown() = 0;
+
+    /**
+     * Called when a Catalogs OTA update is available. Only the client
+     * authorized for Catalogs OTA updates will receive this callback.
+     *
+     * @param aTarget Update target.
+     * @param aId Additional update target id, such as application UID or
+     *  skin ID.
+     * @param aVersion Update version.
+     * @param aUri Uri for downloading the update package.
+     * @param aForce ETrue if the update should be forced (user is not
+     *  asked), EFalse otherwise.
+     */
+    virtual void CatalogsUpdateNotification( 
+        const TDesC& aTarget,
+        const TDesC& aId,
+        const TDesC& aVersion,
+    	const TDesC& aUri,
+        TBool aForce ) = 0;
+
+    /**
+     * Called when connection status changes. This is called when client-
+     * related network activity starts and stops.
+     * 
+     * @param aConnectionActive Connection status. ETrue if connection is active,
+     * EFalse otherwise.
+     */
+    virtual void CatalogsConnectionEvent( TBool aConnectionActive ) = 0;
+    };
+    
+#endif //  M_CATALOGS_ENGINE_OBSERVER_H
\ No newline at end of file