systemhealthmanagement/systemhealthmgr/inc/sysmonclisess.h
author Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
Tue, 11 May 2010 17:23:24 +0300
branchRCL_3
changeset 23 66ecddbca914
parent 0 4e1aa6a622a0
permissions -rw-r--r--
Revision: 201017 Kit: 201019

// Copyright (c) 2006-2009 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:
//

#ifndef __SYSMONCLISESS_H__
#define __SYSMONCLISESS_H__

#include <e32std.h>

class CStartupProperties;
class CSsmStartupProperties;

/**
Client API for monitoring the applications and processes using System Monitor 
Client can use this class to register for process/application monitoring. Upon failure 
of the process/application, System Monitor will try to restart the process according to 
the supplied parameters. If the process still fail to start after the retry limit is 
reached or if the relaunch attempts exceeds the rate of failure policy, the recovery action 
will be taken. The retry action can be ignore failure, restart the system, or restart the system with a specified startup mode, 
and different PlatSec capability is required for each option. See API description for PlatSec capability 
required.

@publishedPartner
@released
*/
NONSHARABLE_CLASS (RSysMonSession) : public RSessionBase
	{
public:
	IMPORT_C RSysMonSession();
	
	IMPORT_C void OpenL();
	IMPORT_C void Close();
	IMPORT_C void MonitorL(const CStartupProperties& aStartupProperties, const RProcess& aProcess, TBool aExecuteRecoveryMethodOnFailure=EFalse);
	IMPORT_C void MonitorSelfL(const CStartupProperties& aStartupProperties);
	IMPORT_C void CancelMonitorSelfL();
	IMPORT_C void MonitorL(const CSsmStartupProperties& aSsmStartupProperties, const RProcess& aProcess, TBool aExecuteRecoveryMethodOnFailure=EFalse);
	IMPORT_C void MonitorSelfL(const CSsmStartupProperties& aSsmStartupProperties);
	IMPORT_C TInt CancelAllMonitors();
		
private:
	void DoMonitorL(const CStartupProperties& aStartupProperties, const RProcess* aProcess, TBool aExecuteRecoveryMethodOnFailure);
	static TInt Validate(const CStartupProperties& aStartupProperties);
	CStartupProperties* ChangeToOldStylePropertiesL(const CSsmStartupProperties& aSsmStartupProperties) const;
	};

#endif