GetFirstInstance Method

Topic Last Modified: 2006-06-13

Returns the first instance of a recurring appointment.

Applies To

IAppointment Interface

Type Library

Microsoft CDO for Exchange 2000 Library

DLL Implemented In

CDOEX.DLL

Syntax

Function GetFirstInstance(    ByVal Start As Date,
        ByVal End As Date) As IAppointment
HRESULT GetFirstInstance
(
        DATE Start,
        DATE End,
        IAppointment** pVal
);

Parameters

  • Start
    The starting date for a range in which to determine the first instance of a recurring appointment.
  • End
    The ending date for a range in which to determine the first instance of a recurring appointment.

Return Value

Returns S_OK if successful, or an error value otherwise.

Remarks

The range calculated by GetFirstInstance starts with the date and time of the first instance. It does not accommodate subsequent changes to the start time for that appointment. For example, if you set the start instance in GetFirstInstance to 3/10/2000 10 am, and later modify that appointment to start at 3/10/2000 2 pm, the GetFirstInstance range remains with the first instance at 3/10/2000 10 am.