/*
* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of the License "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:
*
*/
/**
@test
@internalComponent
*/
#ifndef CANCELTIMER_H
#define CANCELTIMER_H
#include "common.h"
#include "installer.h"
/**
* This class defines the timer that is used to start and cancel
* the installation process at a given time.
*/
class CCancelTimer : public CTimer
{
public:
CCancelTimer();
void ConstructL();
static CCancelTimer* NewLC(CInstallPrefs* aPrefs=NULL);
static CCancelTimer* NewL(CInstallPrefs* aPrefs=NULL);
virtual ~CCancelTimer();
/**
* Sets up the installation (but without starting the Active Scheduler)
* @param aSisToInstall Full path to sis file to be installed
* @param aWhenToCancel Point in time (microseconds) when to cancel the installation
* @param aDontCancel Set to 1 if the installation is not to be canceled
*/
void StartL(const TDesC& aSisToInstall, TInt aWhenToCancel, TInt aDontCancel=0);
// Used to determine how long did the installation process last
TInt Time()
{
return iTime;
}
TInt CancelationSuccess()
{
return iInstaller->CancelationSuccess();
}
TInt FinishedInstallation()
{
return iInstaller->FinishedInstallation();
}
TInt InstallerStatus()
{
return iInstaller->Status();
}
private:
// Ticks and cancels the installation at reqested time.
// Since cancelation takes some time to complete, this function also waits
// for its completition and than stops the Active Scheduler
void RunL();
// Sets the interval after which the next tick will occur
void SetNextTick(TInt aTime=1);
// Stop the Active Scheduler
void StopScheduler();
// Keeps the time in order to know when to cancel.
// Also useful to determine how long did the installation process last
TInt iTime;
TInt iWhenToCancel;
// Is equal to 1 if ActiveScheduler should be stopped the next time
// RunL executes
TInt iStopScheduler;
// Is equal to 1 if the CancelOperation() was requested and the program
// is waiting for the cancelation to finish
TInt iWaitWhileCanceling;
// Runs the installation and cancelation
CInstaller* iInstaller;
};
#endif
// End of file