--- a/epoc32/include/schtask.h	Tue Nov 24 13:55:44 2009 +0000
+++ b/epoc32/include/schtask.h	Tue Mar 16 16:12:26 2010 +0000
@@ -1,1 +1,159 @@
-schtask.h
+// 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