IAppointment

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

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

• IUnknown methods
• IDispatch methods

IAppointment methods	Description
IAppointment::ClearRecurrencePattern	Clears the recurrence for an appointment and marks it as a single instance.
IAppointment::GetRecurrencePattern	Gets the current recurrence pattern for an appointment.
IAppointment::get_IsRecurring	Determines whether the appointment is recurring.
IAppointment::get_Subject	Gets the subject for the appointment.
IAppointment::get_Location	Gets the location for an appointment.
IAppointment::get_Categories	Gets the categories assigned to the appointment.
IAppointment::get_Start	Determines when an appointment starts.
IAppointment::get_Duration	Gets the length of an appointment.
IAppointment::get_End	Determines when the appointment ends.
IAppointment::get_AllDayEvent	Determines whether an appointment is an all day event.
IAppointment::get_BusyStatus	Gets a user's availability during a designated appointment time.
IAppointment::get_Sensitivity	Gets the sensitivity for a meeting as normal or private.
IAppointment::get_Body	Gets the notes or message accompanying an appointment.
IAppointment::get_Recipients	Gets the recipients list as an IRecipients interface object.
IAppointment::get_MeetingStatus	Determines whether the appointment is a meeting.
IAppointment::get_ReminderSet	Determines whether the user wants to be reminded of an appointment.
IAppointment::get_ReminderSoundFile	Gets the path and file name of the sound file to play when the reminder occurs for the appointment.
IAppointment::get_ReminderMinutesBeforeStart	Gets the number of minutes a reminder occurs before the start of an appointment.
IAppointment::get_ReminderOptions	Gets the type of a reminder.
IAppointment::put_Subject	Sets the subject for the appointment.
IAppointment::put_Location	Sets the location for an appointment.
IAppointment::put_Categories	Sets the categories assigned to the appointment.
IAppointment::put_Start	Sets when an appointment starts.
IAppointment::put_Duration	Sets the length of an appointment.
IAppointment::put_End	Sets when the appointment ends.
IAppointment::put_AllDayEvent	Sets whether an appointment is an all day event.
IAppointment::put_BusyStatus	Sets a user's availability during an appointment.
IAppointment::put_Sensitivity	Sets the sensitivity for a meeting as either normal or private.
IAppointment::put_Body	Sets either the message body or the binary representation of the message body accompanying an appointment.
IAppointment::put_ReminderSet	Sets whether the user wants to be reminded of an appointment.
IAppointment::put_ReminderSoundFile	Sets the path and file name of the sound file to play when the reminder occurs for the appointment.
IAppointment::put_ReminderMinutesBeforeStart	Sets the number of minutes a reminder occurs before the start of an appointment.
IAppointment::put_ReminderOptions	Sets the type of a reminder (vibrate etc.).
IAppointment::Save	Saves an appointment item (adds it to the appointment collection).
IAppointment::Send	Sends a meeting request to recipients.
IAppointment::Delete	Deletes an appointment item.
IAppointment::Cancel	Sends a cancellation of a meeting request.
IAppointment::Copy	Adds a copy of an appointment item in the Appointment items collection.
IAppointment::Display	Displays the Appointment item's Summary tab.
IAppointment::get_Oid	Gets the object identifier (OID) for an item.
IAppointment::put_BodyInk	Sets a binary representation of the Appointment body.
IAppointment::get_BodyInk	Gets a binary representation of the Appointment body.
IAppointment::get_Application	Gets the main Outlook Mobile application IPOutlookApp object.

Remarks

POOM does not support the ReminderOverrideDefault property that is supported in the desktop version of Microsoft Outlook. When you create an appointment, Outlook Mobile 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 Outlook Mobile. In Outlook Mobile, an appointment is a meeting request if one or more recipients are specified. The IAppointment::get_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 Outlook Mobile, it is read/write, because POOM 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 POOM, 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

Header	pimstore.h
Library	Pimstore.lib
Windows Embedded CE	Windows CE 2.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Tasks

Creating a PIM Item

Reference

ITask
IContact
Pocket Outlook Object Model Interfaces