Share via


GetRecurringMaster Method

Topic Last Modified: 2006-06-13

Returns the master recurring appointment for an exception or instance of the master appointment.

Applies To

IAppointment Interface

Type Library

Microsoft CDO for Exchange 2000 Library

DLL Implemented In

CDOEX.DLL

Syntax

Function GetRecurringMaster(    ByVal [CalendarLocation As String],
        ByVal [UserName As String],
        ByVal [Password As String]) As IAppointment
HRESULT GetRecurringMaster
(
        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.

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