GetAppointments

Description

Gets an array of appointments from Pocket Outlook after optionally filtering the array for matching criteria.

Applies to

POOM objects

Syntax

Integer objectname.GetAppointments ({matchcriteria,} appointments [ ] )

Argument	Description
objectname	The name of the POOM object
matchcriteria	A string describing criteria you want to use to filter the list of appointments
appointments	An array of POOMAppointments passed by reference

Returns

Integer. Returns 1 for success and one of the following negative values if an error occurs:

-1 Unspecified error
-2 Cannot connect to the repository or a required internal subobject failed to connect to the repository
-3 Cannot log in to the repository
-4 Incorrect input argument
-5 Action cannot be performed
-6 The object identifier (OID) is not in the repository
-7 Feature is not implemented yet
-8 No matching entries found for the criteria

Usage

A user must be logged in to a POOM object to get appointments from Pocket Outlook.

Examples

Example 1

The following example retrieves an array of appointments that satisfy the criterion that the location is the lunch room, and displays the array in a list box:

// global variable: g_poom
integer li_rc
POOMAppointment apptArray[]
POOMAppointment appt

String  sCriteria = "[Location] <> ~"Lunch Room~""
DateTime  dt
int li_idx

li_rc = g_poom.GetAppointments( sCriteria, apptArray )

FOR li_idx=1 to UPPERBOUND(apptArray)
   appt = apptArray[li_idx]
   lb_res.AddItem( "Appt(" + string(li_idx) + ")")
   lb_res.AddItem( "Subject: " + appt.Subject )
   lb_res.AddItem( "Location: " + appt.Location )
   dt = appt.appointmentstart
   lb_res.AddItem( "Start: " +   &
      string(dt, "dd-mmm-yyyy hh:mm") )
   lb_res.AddItem( "End: " +  &
      string(appt.appointmentEnd) )

   lb_res.AddItem( "Duration: " +   &
      string(appt.appointmentduration  ) )
   lb_res.AddItem( "Reminder: " +  &
      string(appt.reminderminutesbeforestart ) )

NEXT