Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

A version of this page is also available for

4/8/2010

The IAppointmentinterface 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

IUnknownmethods
IDispatchmethods

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 IRecipientsinterface 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 Summarytab.
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 IPOutlookAppobject.

Remarks

POOM does not support the ReminderOverrideDefaultproperty 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 MeetingStatusproperty 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_MeetingStatusproperty is read-only, and can take only the OlMeetingStatusenumeration values olNonMeetingand olMeeting.

In desktop Outlook, the Addressproperty is read-only. In Outlook Mobile, it is read/write, because POOM does not provide a Resolvemethod 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 MeetingStatusproperty to olMeetingCanceled. This property is read-only in POOM, so you must call IAppointment::Cancelto send a cancellation method for a meeting. You must subsequently call the IAppointment::Deletemethod 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

Methods in Vtable Order

Remarks

Requirements

See Also

Tasks

Reference