GetAssociatedItem Method

[This is preliminary documentation and subject to change.]

Returns an Appointment object that contains the appointment in the Web Store that has the same identifier (UID) as the appointment in the calendar part. If no appointment in the Web Store has the same UID as the calendar part, the method returns an error.

[Visual Basic,VBScript]
Function GetAssociatedItem(
  [CalendarLocation as String],
  [UserName as String],
  [Password as String]
  ) As IAppointment
[C++]
HRESULT GetAssociatedItem(
  BSTR CalendarLocation,
  BSTR UserName,
  BSTR Password,
  IAppointment** pVal
  );
[IDL]
HRESULT GetAssociatedItem(
  [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/"

This method does not return any information from the appointment in the calendar part.

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