IAppointment
The IAppointment interface represents an appointment in the Calendar folder. An appointment object can represent a meeting, a one-time appointment, or a recurring appointment or meeting.
Methods in Vtable Order
| IAppointment methods | Description |
|---|---|
| ClearRecurrencePattern | Clears the recurrence for an appointment and marks it as a single instance. |
| GetRecurrencePattern | Gets the current recurrence pattern for an appointment. |
| get_IsRecurring | Determines whether the appointment is recurring. |
| get_Subject | Gets the subject for the appointment. |
| get_Location | Gets the location for an appointment. |
| get_Categories | Gets the categories assigned to the appointment. |
| get_Start | Determines when an appointment starts. |
| get_Duration | Gets the length of an appointment. |
| get_End | Determines when the appointment ends. |
| get_AllDayEvent | Determines whether an appointment is an all day event. |
| get_BusyStatus | Gets a user's availability during a designated appointment time. |
| get_Sensitivity | Gets the sensitivity for a meeting as normal or private. |
| get_Body | Gets notes or message accompanying an appointment. |
| get_Recipients | Gets the recipients list as an IRecipients interface object. |
| get_MeetingStatus | Determines whether the appointment is a meeting. |
| get_ReminderSet | Determines whether the user wants to be reminded of an appointment. |
| get_ReminderSoundFile | Gets the path and file name of the sound file to play when the reminder occurs for the appointment. |
| get_ReminderMinutesBeforeStart | Gets the number of minutes a reminder occurs before the start of an appointment. |
| get_ReminderOptions | Gets the type of a reminder. |
| put_Subject | Sets the subject for the appointment. |
| put_Location | Sets the location for an appointment. |
| put_Categories | Sets the categories assigned to the appointment. |
| put_Start | Sets when an appointment starts. |
| put_Duration | Sets the length of an appointment. |
| put_End | Sets when the appointment ends. |
| put_AllDayEvent | Sets whether an appointment is an all day event. |
| put_BusyStatus | Sets a user's availability during an appointment. |
| put_Sensitivity | Sets the sensitivity for a meeting as either normal or private. |
| put_Body | Sets either ink notes or the message body accompanying an appointment. |
| put_ReminderSet | Sets whether the user wants to be reminded of an appointment. |
| put_ReminderSoundFile | Sets the path and file name of the sound file to play when the reminder occurs for the appointment. |
| put_ReminderMinutesBeforeStart | Sets the number of minutes a reminder occurs before the start of an appointment. |
| put_ReminderOptions | Sets the type of a reminder (vibrate etc.). |
| Save | Saves an appointment item (adds it to the appointment collection). |
| Send | Sends a meeting request to recipients. |
| Delete | Deletes an appointment item. |
| Cancel | Sends a cancellation of a meeting request. |
| Copy | Adds a copy of an appointment item in the Items collection. |
| Display | Displays the appointment item's Summary tab. |
| get_Oid | Gets the object identifier (OID) for an item. |
| put_BodyInk | Sets a binary large object (BLOB) containing the note data in a Rich Ink format. |
| get_BodyInk | Gets a binary large object (BLOB) containing the note data in a Rich Ink format. |
| get_Application | Gets the main Pocket Outlook application IPOutlookApp object. |
Remarks
Pocket Outlook does not support the ReminderOverrideDefault property that is supported in the desktop version of Microsoft Outlook. When you create an appointment, Pocket Outlook automatically creates it with the default reminder information. Setting individual reminder properties automatically overrides their defaults.
In the desktop version of Outlook, you must set the MeetingStatus property of an appointment to mark it as a meeting request. This allows you to have appointments with recipients, that are not meeting requests. This is not possible in Pocket Outlook. In Pocket Outlook, an appointment is a meeting request if one or more recipients are specified. The MeetingStatus property is read-only, and can take only the OlMeetingStatus enumeration values olNonMeeting and olMeeting.
In desktop Outlook, the Address property is read-only. In Pocket Outlook, it is read/write, because Pocket Outlook does not provide a Resolve method to resolve the display name to an e-mail address.
To send a cancellation to a meeting in desktop Outlook, you must first set the MeetingStatus property to olMeetingCanceled. This property is read-only in Pocket Outlook, so you must call IAppointment::Cancel to send a cancellation method for a meeting. You must subsequently call the IAppointment::Delete method to remove the meeting from the user's calendar.
Requirements
Smartphone: Windows Mobile 2002 and later
OS Versions: Windows CE 3.0 and later
Header: pimstore.h
Library: pimstore.lib
See Also
Pocket Outlook Object Model API Interfaces
Pocket Outlook Object Model API Enumerations
Last updated on Friday, April 22, 2005
© 2005 Microsoft Corporation. All rights reserved.
Send feedback on this topic to the authors.