--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/menufw/hierarchynavigator/hnengine/inc/hninstallnotifier.h	Thu Dec 17 08:40:49 2009 +0200
@@ -0,0 +1,177 @@
+/*
+* Copyright (c) 2007-2008 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:  Sis package installation event listener
+*
+*/
+  
+
+
+#ifndef HNINSTALLNOTIFIER_H
+#define HNINSTALLNOTIFIER_H
+
+#include <e32base.h>
+#include <e32property.h>
+
+/**
+ * @ingroup group_hnengine
+ *  Interface for observing Sis installation events.
+ *
+ * @lib hnengine
+ * @since S60 S60 v3.1
+ */
+class MHnInstallNotifierCallback
+    {
+    
+public:
+    /**
+     * @ingroup group_hnengine
+     * Enum defining the purpouse of the installation event.
+     */
+    enum TInstOp
+        {
+        EInstOpNone = 0x00, 
+        EInstOpInstall = 0x01, 
+        EInstOpUninstall = 0x02, 
+        EInstOpRestore = 0x04  
+        };
+
+    /**
+     * @ i ngroup group_hnengine
+     * Enum defining the exit status of the installation event.
+     */
+/*    enum TInstOpStatus
+        {
+        EInstOpStatusNone = 0x0000, 
+        EInstOpStatusSuccess = 0x0100, 
+        EInstOpStatusAborted = 0x0200 
+        };*/
+        
+    /**
+     * InstallChangeL is called when the subscribed key has been changed.
+     * 
+     * @param aStatus Status of the installation event.
+     */
+    virtual void InstallChangeL( TInt aStatus ) = 0;
+    
+    };
+
+
+/**
+ * @ingroup group_hnengine
+ *  Central Repository notifier.
+ * 
+ * @lib hnengine
+ * @since S60 S60 v3.1
+ */
+NONSHARABLE_CLASS( CHnInstallNotifier ) : public CActive
+    {
+    
+public:
+
+    /**
+     * Creates an instance of CHnMulModelInstallNotifier implementation.
+     * 
+     * @since S60 v5.0
+     * 
+     * @param aCallback Reference to notifier interface.
+     * @param aCategory Package uid.
+     * @param aKey Key for central repository.
+     * @return Fully constructed object.
+     */
+    static CHnInstallNotifier* NewL( 
+                                   MHnInstallNotifierCallback* aCallback,
+                                   TUid aCategory, 
+                                   TUint aKey );
+
+    /**
+     * Default destructor.
+     * 
+     * @since S60 v5.0
+     */
+    virtual ~CHnInstallNotifier();
+
+
+private:
+    /**
+     * Constructor.
+     * 
+     * @since S60 v5.0
+     * 
+     * @param aCallback Reference to notifier interface.
+     * @param aCategory Package uid.
+     * @param aKey Key for central repository.
+     */
+    CHnInstallNotifier( 
+                                MHnInstallNotifierCallback* aCallback, 
+                                TUid aCategory, 
+                                TUint aKey );
+
+    /**
+     * Symbian 2nd phase constructor.
+     * 
+     * @since S60 v5.0
+     */
+    void ConstructL();
+
+    /**
+     * From CActive. Implements cancellation of an outstanding request.
+     * 
+     * @since S60 v5.0
+     */
+    void DoCancel();
+    
+    /**
+     * From CActive. Handles an active object's request completion event.
+     * 
+     * @since S60 v5.0
+     */
+    void RunL();
+    
+    /**
+     * From CActive.
+     * 
+     * @since S60 v5.0
+     * @param aError The leave code.
+     * @return Status code.
+     */
+    TInt RunError( TInt aError );
+    
+        
+private:
+    /**
+     * User side interface to Publish & Subscribe.
+     */
+    RProperty iProperty;
+
+    /**
+     * Interface for notifying changes in SWI.
+     * Not own.
+     */
+    MHnInstallNotifierCallback* iCallback;
+    
+    /**
+     * Category uid.
+     */
+    TUid    iCategory;
+    
+    /**
+     * Key identifier.
+     */
+    TUint   iKey;
+
+    };
+
+#endif // HNINSTALLNOTIFIER_H
+
+// End of File