IAppointment::Save

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

The Save method saves an Appointment item to the item store database.

Syntax

HRESULT Save ();

Return Value

This method returns the standard values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, and E_FAIL, as well as the following:

• E_CANTCHANGEDATE
  The user changed the date, and it should have thrown an exception—but it did not.

• E_EXCEPTIONSAMEDAY
  The user changed the date, and it overlaps with another date, and it should have thrown an exception — but it did not.

• E_OVERLAPPINGEXCEPTION
  The Appointment is not valid because it overlaps another Appointment (and generated an Overlapping Exception).

• E_INVALIDDATES
  The Appointment is not valid because its recurrence duration (minimum period) is greater than the length of the recurrence pattern.

• E_INVALIDREMINDERTIME
  The Appointment is not valid because its recurrence duration (minimum period) is not greater than or equal to the length of time before the Appointment reminder.

• S_OK
  The method completed successfully.

Remarks

If the recurrence information was changed, then the IRecurrencePattern object is automatically updated with new values for StartTime, EndTime, and Duration.

Saved time values are in the current Time Zone.

If the list of recipients changes, then the IRecipients object is automatically updated with the new information, and the attendees will be sent an update.

You must call IAppointment::Save on the Appointment before using IItem::SetProps to set either Calendar Property ID's or Calendar Property ID's.

Requirements

See Also

Tasks

Creating a PIM Item

Reference

IAppointment
Pocket Outlook Object Model Interfaces

Other Resources

Pocket Outlook Object Model Enumerations