/*
* Copyright (c) 1020 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: process monitor.
*/


#ifndef __HS_PROCESS_MONITOR__
#define __HS_PROCESS_MONITOR__

#include <e32base.h>

/**
 * MHsProcessMonitorObserver
 * 
 * Monitor component observer.
 * 
 * @since S60 5.2
 */
class MHsProcessMonitorObserver
    {    
    public:
        /**
         * Called when monitored process is ended.
         * 
         * @param aExitType         Exit type
         * @param aExitReason       Exit reason
         * @param aExitCategory     Exit category
         */
        virtual void ProcessEnded( const TExitType& aExitType,
                                   const TInt aExitReason,
                                   const TExitCategoryName& aExitCategory ) = 0;

        /**
         * Called when error occured during monitoring.
         * 
         * @param aError System wide error code.
         */        
        virtual void ProcessMonitoringError( TInt aError ) = 0;											
    };

/**
 * HsProcessMonitor
 * 
 * Component for monitoring process states.
 * 
 * @since S60 5.2
 */  
class CHsProcessMonitor : public CActive
    {
    public:
        /**
         * Create new monitor
         * 
         * @param aProcessName	process id
         * @param aObserver monitor observer
         * @since S60 5.2     
         */    
        static CHsProcessMonitor* NewL( const TInt aProcessId,
                                        MHsProcessMonitorObserver& aObserver );   
        
        /**
         * Destructor
         * 
         * @since S60 5.2     
         */    
        ~CHsProcessMonitor();
    
        /**
         * Attach monitor
         * 
         * @return TInt     System wide error code.       
         * @since S60 5.2
         */        
        TInt AttachMonitor();
        
        /**
         * Start monitor
         * 
         * @return TInt     System wide error code.
         * @since S60 5.2
         */        
        TInt StartMonitor();        

    protected:
        /** 
         * C++ constructor
         *
         * @param aProcessName  process id
         * @param aObserver     watchdog observer.   
         * @since S60 5.2      
         */        
        CHsProcessMonitor( const TInt aProcessId,
                           MHsProcessMonitorObserver& aObserver );    

        /**
         * Symbian 2nd phase constructor
         * 
         * @since S60 5.2
         */        
        void ConstructL();

    private: // From CActive
        /**
         * From CActive
         */        
        void RunL();

        /**
         * From CActive
         * 
         * @since S60 5.2
         */        
        void DoCancel(); 

        /**
         * From CActive
         * 
         * @since S60 5.2
         */        
        TInt RunError( TInt aError );

    private: // New methods
        /**
         * Close process handle if open
         * 
         * @since S60 5.2
         */        
        void SecureProcessHandleAsClosed();     

    private:	
        // process id
        TInt iProcessId;        
        
        // watchdog observer
        MHsProcessMonitorObserver& iObserver;
        
        // Process handle
        RProcess iProcess;
        
        // boolean to represent whether process handle is open
        TBool iProcessHandleOpen;        
    };

#endif // __HS_PROCESS_MONITOR__