/*
* 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