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 Savemethod 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 IRecurrencePatternobject 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 IRecipientsobject is automatically updated with the new information, and the attendees will be sent an update.

You must call IAppointment::Saveon the Appointment before using IItem::SetPropsto set either Calendar Property ID'sor Calendar Property ID's.

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