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

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

See Also