diff -r ff572005ac23 -r 1a2a00e78665 idlefw/hslaunch/inc/hsprocessmonitor.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/idlefw/hslaunch/inc/hsprocessmonitor.h Tue Feb 02 00:23:10 2010 +0200 @@ -0,0 +1,155 @@ +/* +* 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 + +/** + * 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__