epoc32/include/schtask.h
author William Roberts <williamr@symbian.org>
Tue, 16 Mar 2010 16:12:26 +0000
branchSymbian2
changeset 2 2fe1408b6811
parent 0 061f57f2323e
child 4 837f303aceeb
permissions -rw-r--r--
Final list of Symbian^2 public API header files

// Copyright (c) 2004-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 "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members
// which accompanies this distribution, and is available
// at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
//
// Initial Contributors:
// Nokia Corporation - initial contribution.
//
// Contributors:
//
// Description:
// Representation of a task: 
// Includes both user-defined data (iInfo+iData) and data set by system
// construction from stream & accessors are exported for task executors
// 
//

#if !defined(__SCHTASK_H__)
#define __SCHTASK_H__

#if !defined(__SCHINFO_H__)
#include <schinfo.h>
#endif 

#include <s32file.h>


/**
@publishedPartner

When SYMBIAN_SECURE_TASK_SCHEDULER is defined, platform security
support functionality is included in Task Scheduler.

This means that:

(i) Scheduled executables will be passed a shared file handle to
the scheduled task file by the Task Scheduler.

(ii) The CScheduledTask::SecurityInfo() API is availble to
retrieve security information about the schedule creator.
*/
#ifndef SYMBIAN_SECURE_TASK_SCHEDULER
#define SYMBIAN_SECURE_TASK_SCHEDULER
#endif

/**
Class used by registered programs to access the scheduled task file store.

When tasks are due, the Task Scheduler encapsulates task information within 
CScheduledTask objects, and externalises them to a direct file store.

This file store is located in the task scheduler's private data cage and thus
cannot be accessed directly.  Instead the task scheduler passes a shared RFs and
RFile handle to the registered program.

The registered program can use the RFile::AdoptFromCreator API in conjunction
with the APIs provided by this class to access the scheduled task file store as
shown in the following example:

@code
	RFile file;
	TInt error = file.AdoptFromCreator(TScheduledTaskFile::FsHandleIndex(),
											TScheduledTaskFile::FileHandleIndex());
@endcode
@see CScheduledTask
@see RFile::AdoptFromCreator
@publishedAll
@released
*/
class TScheduledTaskFile
	{
public:
	IMPORT_C static TInt FsHandleIndex();
	IMPORT_C static TInt FileHandleIndex();
	};

/** 
The representation of a scheduled task that is passed to registered programs.

When tasks are due, the Task Scheduler encapsulates task information within 
CScheduledTask objects, and externalises them to a direct file store.

The root stream of the direct file store contains a 32 bit value, followed 
by the external representations of one or more CScheduledTask objects. The 
32 bit value is interpreted as a TInt32 and contains the number of CScheduledTask 
objects that follow in the stream.

The registered program can create successive CScheduledTask objects from this 
stream using the static NewLC() function.
 
@see TScheduledTaskFile
@see RStoreReadStream 
@publishedAll
@released
*/
class CScheduledTask : public CBase
	{
public:
	IMPORT_C static CScheduledTask* NewLC(RReadStream& aStream);
	~CScheduledTask();
	IMPORT_C const TTaskInfo& Info() const;
	IMPORT_C const HBufC& Data() const;
	IMPORT_C const TTsTime& ValidUntil() const;
	IMPORT_C TScheduleType ScheduleType() const;
	IMPORT_C const TSecurityInfo& SecurityInfo() const;
	
	// These methods only used by task scheduler server
	CScheduledTask(TTaskInfo& aInfo, 
					HBufC* aData, 
					TScheduleType aScheduleType,
					const TSecurityInfo& aSecurityInfo);

	TBool Due() const;
	void SetDue(TBool aDue);
	void OnDue(const TTsTime& aValidUntil);
	void DecRepeat();
	void Remove();
	void ExternalizeL(RWriteStream& aStream) const;
	//
	TInt ScheduleId() const;
	void SetScheduleId(TInt aScheduleId);	
	//
	TBool Persists() const;
	void SetPersists();
	//
	static TInt Offset();
	//
private:
	CScheduledTask();	
	void InternalizeL(RReadStream& aStream);
private:
	TPriQueLink iPLink;
	TTaskInfo iInfo;
	HBufC* iData;
	TTsTime iValidUntil;
	TBool iDue;
	TInt iScheduleId;
	TScheduleType iScheduleType;
	TSecurityInfo iSecurityInfo;
	TBool iPersists;
	};
	
/**
Streaming operators for TSecurityInfo
@internalComponent
*/	
RWriteStream& operator<<(RWriteStream& aWriteStream, 
						const TSecurityInfo& aSecurityInfo);

/**
Streaming operators for TSecurityInfo
@internalComponent
*/	
RReadStream& operator>>(RReadStream& aReadStream,
						TSecurityInfo& aSecurityInfo);

#endif