IAppointment::Save
A version of this page is also available for
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
| 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
Reference
IAppointment
Pocket Outlook Object Model Interfaces