Share via

GetUpdatedItem Method

  • Article

GetUpdatedItem Method

This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.

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 Exchange store contains a meeting with the same globally unique identifier (GUID) as the meeting in the calendar part, this method returns the meeting that was updated most recently. If no meeting in the Exchange store has the same GUID 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 Exchange store.

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 Exchange store.

Applies To

ICalendarPart Interface

Type Library

Microsoft CDO for Exchange 2000 Library

DLL Implemented In

CDOEX.DLL

Syntax



[Visual Basic]Function GetUpdatedItem
(
    [CalendarLocation As String],
    [UserName As String],
    [Password As String]
) As IAppointment






[C++]HRESULT GetUpdatedItem
(
    BSTR CalendarLocation,
    BSTR UserName,
    BSTR Password,
    IAppointment** pVal
);



Parameters




    

  • 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.
    • 

  • pVal
    
Returned reference to an IAppointment Interface.
    • 





Return Value




Returns S_OK if successful, or an error value otherwise.




Remarks




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




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





If the calendar location is not specified in the method parameters, Collaboration Data Objects (CDO) uses the calendar location from the Configuration object. The following Visual Basic 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





Note  These examples use a file URL with the Microsoft ExchangeOLE DB (ExOLEDB) provider. The ExOLEDB provider also supports The HTTP: URL Scheme.




Send us your feedback about the Microsoft Exchange Server 2003 SDK.


Build: June 2007 (2007.618.1)


© 2003-2006 Microsoft Corporation. All rights reserved. Terms of use.