GetUpdatedItem Method

[This is preliminary documentation and subject to change.]

Returns the Appointment object that contains the latest updated version of a meeting. This method is used to process updates to meetings and meeting responses.

If the Web Store contains a meeting with the same identifier (UID) as the meeting in the calendar part, this method returns the meeting that was updated most recently. If no meeting in the Web Store has the same UID as the meeting in the calendar part, this method returns the meeting from the calendar part.

When you save the meeting returned by this method, it overwrites the meeting in the Web store.

Note   If the calendar part contains an exception to an existing recurring meeting, the GetUpdatedItem method returns the exception in memory. If you accept or decline the exception, the meeting response is based on the exception. However, when you call the IDataSource.Save method on the exception, it merges the exception into the master recurring meeting and saves the updated master to the Web Store.

[Visual Basic,VBScript]
Function GetUpdatedItem(
  [CalendarLocation as String],
  [UserName as String],
  [Password as String]
  ) As IAppointment
[C++]
HRESULT GetUpdatedItem(
  BSTR CalendarLocation,
  BSTR UserName,
  BSTR Password,
  IAppointment** pVal
  );
[IDL]
HRESULT GetUpdatedItem(
  [in,optional]BSTR CalendarLocation,
  [in,optional]BSTR UserName,
  [in,optional]BSTR Password,
  [out,retval] IAppointment** pVal);

CalendarLocation

The location of the calendar folder.

UserName

A user who has read/write permission to the folder specified by the CalendarLocation parameter.

Password

The user's password.

Remarks

For calendar folders in the private store, the format of the CalendarLocation string is:

"file://./backofficestorage/<domain_name>/<private_store>/<user_name>/calendar/"

If the calendar location is not specified in the method parameters, CDO uses the calendar location from the Configuration object. The following code sets the calendar location field in the Configuration object.

Dim Config    As New Configuration
Config.Fields("CalendarLocation") = "file://./backofficestorage/domain/MBX/user/calendar"
Config.Fields.Update