Reads the first task found in the task list of a Lotus Notes or Outlook messaging. This task becomes the current task.
When reading a task, the data of this task is updated in the
Task structure. To retrieve the data of the current task, all you have to do is retrieve the values of the
Task structure.
Caution: This function cannot be used to read the first task found in the task list of an Outlook Express messaging.
// Start a Lotus Notes session
SessionID is int
SessionID = EmailStartNotesSession("Password", "MarsServer", "email/julia.nsf",...
"C:\Users\Julia\AppData\Local\Lotus\Notes\Data\user.id")
// Read the first task
TaskFirst(SessionID)
// Add the tasks found into a list
WHILE mTask.Out = False
ListAdd(LIST_TaskList, mTask.Subject + TAB + mTask.Category)
TaskNext(SessionID)
END
// Start an Outlook session
SessionID is int
SessionID = OutlookStartSession("MyProfile")
// Read the first task
TaskFirst(SessionID)
// Add the tasks found into a list
WHILE mTask.Out = False
ListAdd(LIST_TaskList, mTask.Subject + TAB + mTask.Category)
TaskNext(SessionID)
END
Syntax
<Result> = TaskFirst(<Session identifier>)
Remarks
The mTask.Out variable is used to find out whether a current task exists.