Symbian3/Examples/guid-6013a680-57f9-415b-8851-c4fa63356636/class_c_task_schedule.html
changeset 1 25a17d01db0c
child 6 43e37759235e
equal deleted inserted replaced
0:89d6a7a84779 1:25a17d01db0c
       
     1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
       
     2 <html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
       
     3 <title>TB10.1 Example Applications: CTaskSchedule Class Reference</title>
       
     4 <link href="doxygen.css" rel="stylesheet" type="text/css">
       
     5 <link href="tabs.css" rel="stylesheet" type="text/css">
       
     6 </head><body>
       
     7 <!-- Generated by Doxygen 1.5.3 -->
       
     8 <h1>CTaskSchedule Class Reference</h1><!-- doxytag: class="CTaskSchedule" -->
       
     9 <p>
       
    10 <a href="class_c_task_schedule-members.html">List of all members.</a><table border="0" cellpadding="0" cellspacing="0">
       
    11 <tr><td></td></tr>
       
    12 <tr><td colspan="2"><br><h2>Public Member Functions</h2></td></tr>
       
    13 <tr><td class="memItemLeft" nowrap align="right" valign="top">&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_c_task_schedule.html#739ccbea3ef8f1dc76440e829f206fb6">~CTaskSchedule</a> ()</td></tr>
       
    14 
       
    15 <tr><td class="memItemLeft" nowrap align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_c_task_schedule.html#c957da1838fe31cb3f7fe9f6a533f6c5">ConnectAndRegisterL</a> ()</td></tr>
       
    16 
       
    17 <tr><td class="memItemLeft" nowrap align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_c_task_schedule.html#5b7869136d2a8f1c625531ab1c12ef98">PersistentScheduleL</a> ()</td></tr>
       
    18 
       
    19 <tr><td class="memItemLeft" nowrap align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_c_task_schedule.html#c2ed627ab19ecc8d397b63ceacd6aaa4">CreatePersistentScheduleL</a> (TSchedulerItemRef &amp;aRef, const TTsTime &amp;aStartTime)</td></tr>
       
    20 
       
    21 <tr><td class="memItemLeft" nowrap align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_c_task_schedule.html#abfef5ace0331f83eb8cd4de511d3d7f">CreateTransientScheduleL</a> ()</td></tr>
       
    22 
       
    23 <tr><td class="memItemLeft" nowrap align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_c_task_schedule.html#3b047bd6e178cbc4964d69adb56e1945">DoesScheduledItemExistL</a> (TSchedulerItemRef &amp;aRef, TBool &amp;aExists)</td></tr>
       
    24 
       
    25 <tr><td class="memItemLeft" nowrap align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_c_task_schedule.html#0c3db205409436a0b47b3e11c9d3190f">DeleteSchedulesL</a> (TSchedulerItemRef &amp;aRef, TScheduleFilter aFilter)</td></tr>
       
    26 
       
    27 <tr><td colspan="2"><br><h2>Static Public Member Functions</h2></td></tr>
       
    28 <tr><td class="memItemLeft" nowrap align="right" valign="top">static <a class="el" href="class_c_task_schedule.html">CTaskSchedule</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="class_c_task_schedule.html#d152b61017146041468ce89a4312ddf9">NewLC</a> ()</td></tr>
       
    29 
       
    30 </table>
       
    31 <hr><a name="_details"></a><h2>Detailed Description</h2>
       
    32 <a class="el" href="class_c_task_schedule.html">CTaskSchedule</a> is a class that publicly inherits from CBase class<p>
       
    33 The class demonstrates how to connect and register with the task scheduler server, create persistent and transient schedules and to delete the persistent tasks and schedules. 
       
    34 <p>Definition at line <a class="el" href="taskscheduler_8h-source.html#l00035">35</a> of file <a class="el" href="taskscheduler_8h-source.html">taskscheduler.h</a>.</p>
       
    35 <hr><h2>Constructor &amp; Destructor Documentation</h2>
       
    36 <a class="anchor" name="739ccbea3ef8f1dc76440e829f206fb6"></a><!-- doxytag: member="CTaskSchedule::~CTaskSchedule" ref="739ccbea3ef8f1dc76440e829f206fb6" args="()" -->
       
    37 <div class="memitem">
       
    38 <div class="memproto">
       
    39       <table class="memname">
       
    40         <tr>
       
    41           <td class="memname">CTaskSchedule::~CTaskSchedule           </td>
       
    42           <td>(</td>
       
    43           <td class="paramname">          </td>
       
    44           <td>&nbsp;)&nbsp;</td>
       
    45           <td width="100%"></td>
       
    46         </tr>
       
    47       </table>
       
    48 </div>
       
    49 <div class="memdoc">
       
    50 
       
    51 <p>
       
    52 Destructor 
       
    53 <p>Definition at line <a class="el" href="taskscheduler_8cpp-source.html#l00089">89</a> of file <a class="el" href="taskscheduler_8cpp-source.html">taskscheduler.cpp</a>.</p>
       
    54 
       
    55 </div>
       
    56 </div><p>
       
    57 <hr><h2>Member Function Documentation</h2>
       
    58 <a class="anchor" name="d152b61017146041468ce89a4312ddf9"></a><!-- doxytag: member="CTaskSchedule::NewLC" ref="d152b61017146041468ce89a4312ddf9" args="()" -->
       
    59 <div class="memitem">
       
    60 <div class="memproto">
       
    61       <table class="memname">
       
    62         <tr>
       
    63           <td class="memname"><a class="el" href="class_c_task_schedule.html">CTaskSchedule</a> * CTaskSchedule::NewLC           </td>
       
    64           <td>(</td>
       
    65           <td class="paramname">          </td>
       
    66           <td>&nbsp;)&nbsp;</td>
       
    67           <td width="100%"><code> [static]</code></td>
       
    68         </tr>
       
    69       </table>
       
    70 </div>
       
    71 <div class="memdoc">
       
    72 
       
    73 <p>
       
    74 Allocates and constructs a <a class="el" href="class_c_task_schedule.html">CTaskSchedule</a> object using two phase construction Initialises all member data to their default values. 
       
    75 <p>Definition at line <a class="el" href="taskscheduler_8cpp-source.html#l00064">64</a> of file <a class="el" href="taskscheduler_8cpp-source.html">taskscheduler.cpp</a>.</p>
       
    76 
       
    77 </div>
       
    78 </div><p>
       
    79 <a class="anchor" name="c957da1838fe31cb3f7fe9f6a533f6c5"></a><!-- doxytag: member="CTaskSchedule::ConnectAndRegisterL" ref="c957da1838fe31cb3f7fe9f6a533f6c5" args="()" -->
       
    80 <div class="memitem">
       
    81 <div class="memproto">
       
    82       <table class="memname">
       
    83         <tr>
       
    84           <td class="memname">void CTaskSchedule::ConnectAndRegisterL           </td>
       
    85           <td>(</td>
       
    86           <td class="paramname">          </td>
       
    87           <td>&nbsp;)&nbsp;</td>
       
    88           <td width="100%"></td>
       
    89         </tr>
       
    90       </table>
       
    91 </div>
       
    92 <div class="memdoc">
       
    93 
       
    94 <p>
       
    95 Connects a client to the task scheduler server by creating a session with that server and registers the client with the scheduler.  system-wide error codes. 
       
    96 <p>Definition at line <a class="el" href="taskscheduler_8cpp-source.html#l00104">104</a> of file <a class="el" href="taskscheduler_8cpp-source.html">taskscheduler.cpp</a>.</p>
       
    97 
       
    98 </div>
       
    99 </div><p>
       
   100 <a class="anchor" name="5b7869136d2a8f1c625531ab1c12ef98"></a><!-- doxytag: member="CTaskSchedule::PersistentScheduleL" ref="5b7869136d2a8f1c625531ab1c12ef98" args="()" -->
       
   101 <div class="memitem">
       
   102 <div class="memproto">
       
   103       <table class="memname">
       
   104         <tr>
       
   105           <td class="memname">void CTaskSchedule::PersistentScheduleL           </td>
       
   106           <td>(</td>
       
   107           <td class="paramname">          </td>
       
   108           <td>&nbsp;)&nbsp;</td>
       
   109           <td width="100%"></td>
       
   110         </tr>
       
   111       </table>
       
   112 </div>
       
   113 <div class="memdoc">
       
   114 
       
   115 <p>
       
   116 Creates a persistent schedule task by calling <a class="el" href="class_c_task_schedule.html#c2ed627ab19ecc8d397b63ceacd6aaa4">CreatePersistentScheduleL()</a>. Launches the task executor after adding and scheduling the task.  KErrArgument  system-wide error codes. 
       
   117 <p>Definition at line <a class="el" href="taskscheduler_8cpp-source.html#l00130">130</a> of file <a class="el" href="taskscheduler_8cpp-source.html">taskscheduler.cpp</a>.</p>
       
   118 
       
   119 </div>
       
   120 </div><p>
       
   121 <a class="anchor" name="c2ed627ab19ecc8d397b63ceacd6aaa4"></a><!-- doxytag: member="CTaskSchedule::CreatePersistentScheduleL" ref="c2ed627ab19ecc8d397b63ceacd6aaa4" args="(TSchedulerItemRef &amp;aRef, const TTsTime &amp;aStartTime)" -->
       
   122 <div class="memitem">
       
   123 <div class="memproto">
       
   124       <table class="memname">
       
   125         <tr>
       
   126           <td class="memname">void CTaskSchedule::CreatePersistentScheduleL           </td>
       
   127           <td>(</td>
       
   128           <td class="paramtype">TSchedulerItemRef &amp;&nbsp;</td>
       
   129           <td class="paramname"> <em>aRef</em>, </td>
       
   130         </tr>
       
   131         <tr>
       
   132           <td class="paramkey"></td>
       
   133           <td></td>
       
   134           <td class="paramtype">const TTsTime &amp;&nbsp;</td>
       
   135           <td class="paramname"> <em>aStartTime</em></td><td>&nbsp;</td>
       
   136         </tr>
       
   137         <tr>
       
   138           <td></td>
       
   139           <td>)</td>
       
   140           <td></td><td></td><td width="100%"></td>
       
   141         </tr>
       
   142       </table>
       
   143 </div>
       
   144 <div class="memdoc">
       
   145 
       
   146 <p>
       
   147 Creates a persistent time based schedule with no tasks associated with it but merely contains start and end time information. A persistent schedule is a schedule whose lifetime is not limited to the lifetime of the tasks associated with it. Persistent schedules have their information persisted to disk. On device reboot, this data is read back into memory by the task scheduler server. <dl compact><dt><b>Parameters:</b></dt><dd>
       
   148   <table border="0" cellspacing="2" cellpadding="0">
       
   149     <tr><td valign="top"></td><td valign="top"><em>aRef</em>&nbsp;</td><td>Reference to TSchedulerItemRef for unique identification of the schedule </td></tr>
       
   150     <tr><td valign="top"></td><td valign="top"><em>aStartTime</em>&nbsp;</td><td>Reference to TTsTime class</td></tr>
       
   151   </table>
       
   152 </dl>
       
   153 KErrArgument  system-wide error codes. 
       
   154 <p>Definition at line <a class="el" href="taskscheduler_8cpp-source.html#l00197">197</a> of file <a class="el" href="taskscheduler_8cpp-source.html">taskscheduler.cpp</a>.</p>
       
   155 
       
   156 </div>
       
   157 </div><p>
       
   158 <a class="anchor" name="abfef5ace0331f83eb8cd4de511d3d7f"></a><!-- doxytag: member="CTaskSchedule::CreateTransientScheduleL" ref="abfef5ace0331f83eb8cd4de511d3d7f" args="()" -->
       
   159 <div class="memitem">
       
   160 <div class="memproto">
       
   161       <table class="memname">
       
   162         <tr>
       
   163           <td class="memname">void CTaskSchedule::CreateTransientScheduleL           </td>
       
   164           <td>(</td>
       
   165           <td class="paramname">          </td>
       
   166           <td>&nbsp;)&nbsp;</td>
       
   167           <td width="100%"></td>
       
   168         </tr>
       
   169       </table>
       
   170 </div>
       
   171 <div class="memdoc">
       
   172 
       
   173 <p>
       
   174 Creates a new, transient, time based schedule, adds a task to it and then edits the schedule and executes the edited schedule. Launches the task executor after scheduling the task. A transient schedule is destroyed when the task is destroyed or power is lost.  KErrArgument  system-wide error codes. 
       
   175 <p>Definition at line <a class="el" href="taskscheduler_8cpp-source.html#l00240">240</a> of file <a class="el" href="taskscheduler_8cpp-source.html">taskscheduler.cpp</a>.</p>
       
   176 
       
   177 </div>
       
   178 </div><p>
       
   179 <a class="anchor" name="3b047bd6e178cbc4964d69adb56e1945"></a><!-- doxytag: member="CTaskSchedule::DoesScheduledItemExistL" ref="3b047bd6e178cbc4964d69adb56e1945" args="(TSchedulerItemRef &amp;aRef, TBool &amp;aExists)" -->
       
   180 <div class="memitem">
       
   181 <div class="memproto">
       
   182       <table class="memname">
       
   183         <tr>
       
   184           <td class="memname">void CTaskSchedule::DoesScheduledItemExistL           </td>
       
   185           <td>(</td>
       
   186           <td class="paramtype">TSchedulerItemRef &amp;&nbsp;</td>
       
   187           <td class="paramname"> <em>aRef</em>, </td>
       
   188         </tr>
       
   189         <tr>
       
   190           <td class="paramkey"></td>
       
   191           <td></td>
       
   192           <td class="paramtype">TBool &amp;&nbsp;</td>
       
   193           <td class="paramname"> <em>aExists</em></td><td>&nbsp;</td>
       
   194         </tr>
       
   195         <tr>
       
   196           <td></td>
       
   197           <td>)</td>
       
   198           <td></td><td></td><td width="100%"></td>
       
   199         </tr>
       
   200       </table>
       
   201 </div>
       
   202 <div class="memdoc">
       
   203 
       
   204 <p>
       
   205 Checks if a schedule exists <dl compact><dt><b>Parameters:</b></dt><dd>
       
   206   <table border="0" cellspacing="2" cellpadding="0">
       
   207     <tr><td valign="top"></td><td valign="top"><em>aRef</em>&nbsp;</td><td>Reference to TSchedulerItemRef for unique identification of the schedule </td></tr>
       
   208     <tr><td valign="top"></td><td valign="top"><em>aExists</em>&nbsp;</td><td>TBool value, ETrue if the schedule exists, EFalse otherwise  system wide error codes </td></tr>
       
   209   </table>
       
   210 </dl>
       
   211 
       
   212 <p>Definition at line <a class="el" href="taskscheduler_8cpp-source.html#l00353">353</a> of file <a class="el" href="taskscheduler_8cpp-source.html">taskscheduler.cpp</a>.</p>
       
   213 
       
   214 </div>
       
   215 </div><p>
       
   216 <a class="anchor" name="0c3db205409436a0b47b3e11c9d3190f"></a><!-- doxytag: member="CTaskSchedule::DeleteSchedulesL" ref="0c3db205409436a0b47b3e11c9d3190f" args="(TSchedulerItemRef &amp;aRef, TScheduleFilter aFilter)" -->
       
   217 <div class="memitem">
       
   218 <div class="memproto">
       
   219       <table class="memname">
       
   220         <tr>
       
   221           <td class="memname">void CTaskSchedule::DeleteSchedulesL           </td>
       
   222           <td>(</td>
       
   223           <td class="paramtype">TSchedulerItemRef &amp;&nbsp;</td>
       
   224           <td class="paramname"> <em>aRef</em>, </td>
       
   225         </tr>
       
   226         <tr>
       
   227           <td class="paramkey"></td>
       
   228           <td></td>
       
   229           <td class="paramtype">TScheduleFilter&nbsp;</td>
       
   230           <td class="paramname"> <em>aFilter</em></td><td>&nbsp;</td>
       
   231         </tr>
       
   232         <tr>
       
   233           <td></td>
       
   234           <td>)</td>
       
   235           <td></td><td></td><td width="100%"></td>
       
   236         </tr>
       
   237       </table>
       
   238 </div>
       
   239 <div class="memdoc">
       
   240 
       
   241 <p>
       
   242 Delete all tasks and schedules created by this exe before program exit <dl compact><dt><b>Parameters:</b></dt><dd>
       
   243   <table border="0" cellspacing="2" cellpadding="0">
       
   244     <tr><td valign="top"></td><td valign="top"><em>TSchedulerItemRef</em>&nbsp;</td><td>Reference to TSchedulerItemRef for unique identification of the schedule </td></tr>
       
   245     <tr><td valign="top"></td><td valign="top"><em>TScheduleFilter</em>&nbsp;</td><td>Reference to a filter when listing the schedules</td></tr>
       
   246   </table>
       
   247 </dl>
       
   248 KErrNotFound  KErrAbort  KErrPermissionDenied,  KErrArgument  system-wide error codes. 
       
   249 <p>Definition at line <a class="el" href="taskscheduler_8cpp-source.html#l00395">395</a> of file <a class="el" href="taskscheduler_8cpp-source.html">taskscheduler.cpp</a>.</p>
       
   250 
       
   251 </div>
       
   252 </div><p>
       
   253 <hr size="1"><address style="text-align: right;"><small>Generated on Thu Jan 21 10:33:07 2010 for TB10.1 Example Applications by&nbsp;
       
   254 <a href="http://www.doxygen.org/index.html">
       
   255 <img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.3 </small></address>
       
   256 </body>
       
   257 </html>