Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

The IRecurrencePatterninterface provides read-write access to recurrence pattern objects associated with Task and Appointment items. You can get an IRecurrencePatternobject by calling either ITask::GetRecurrencePatternor IAppointment::GetRecurrencePattern

Methods in Vtable Order

IRecurrencePattern methods Description

IRecurrencePattern::get_RecurrenceType

Gets an integer value that represents the recurrence type for an appointment or task.

IRecurrencePattern::get_PatternStartDate

Gets a Variant time date object that represents the start date of the recurrence pattern.

IRecurrencePattern::get_StartTime

Gets a Variant time date object that represents the start time for a recurring appointment.

IRecurrencePattern::get_EndTime

Gets a Variant time date object that represents the end of a recurring appointment.

IRecurrencePattern::get_PatternEndDate

Gets a Variant time date object that represents the end date of the recurrence.

IRecurrencePattern::get_NoEndDate

Gets a Boolean value indicating whether the recurrence has an end date.

IRecurrencePattern::get_Occurrences

Gets an integer value indicating the number of occurrences in the recurrence pattern.

IRecurrencePattern::get_Interval

Gets the number of units between occurrences (days, weeks, months), from 1 to 999.

IRecurrencePattern::get_DayOfWeekMask

Gets a bitmask that represents the combination of OlDaysOfWeekenumeration values that make up a recurrence pattern.

IRecurrencePattern::get_DayOfMonth

Gets a value between 1 and 31, inclusive, that represents a recurrence pattern expressed as a day of the month.

IRecurrencePattern::get_Instance

Gets an integer value between 1 and 5, inclusive, that represents a recurrence pattern expressed as a week of the month.

IRecurrencePattern::get_Duration

Gets the length of a recurring appointment.

IRecurrencePattern::get_MonthOfYear

Gets an integer value between 1 and 12, inclusive, that represents a recurrence pattern expressed as a month of the year.

IRecurrencePattern::put_RecurrenceType

Sets the type of recurrence for Appointment and Task items.

IRecurrencePattern::put_PatternStartDate

Sets the start date of the recurrence pattern.

IRecurrencePattern::put_StartTime

Sets the start time of the recurrence pattern.

IRecurrencePattern::put_EndTime

Sets the end time of the recurrence pattern.

IRecurrencePattern::put_PatternEndDate

Sets the end date of the recurrence pattern.

IRecurrencePattern::put_NoEndDate

Sets a Boolean value indicating whether the recurrence pattern has an end date.

IRecurrencePattern::put_Occurrences

Sets the number of occurrences in the recurrence pattern.

IRecurrencePattern::put_Interval

Sets the time span between occurrences (days, weeks, months), from 1 to 999.

IRecurrencePattern::put_DayOfWeekMask

Sets a bitmask that represents the combination of OlDaysOfWeekenumeration values that make up a recurrence pattern.

IRecurrencePattern::put_DayOfMonth

Sets a recurrence pattern expressed as a day of the month.

IRecurrencePattern::put_Instance

Sets the duration of a recurrence pattern expressed as a day of the week, a week of the month, or a month of the year.

IRecurrencePattern::put_Duration

Sets the duration of a recurrence pattern expressed as a day of the week, a week of the month, or a month of the year.

IRecurrencePattern::put_MonthOfYear

Sets a recurrence pattern expressed as a month of the year.

IRecurrencePattern::get_Exceptions

Gets a collection of exceptions that are associated with a recurring appointment object.

IRecurrencePattern::get_Application

Gets the main Outlook Mobile IPOutlookAppobject.

IRecurrencePattern::GetOccurrence

Gets a specific instance of an appointment for a specific date.

Remarks

When you create a recurring Appointment, the IRecurrencePatternobject gets the StartTime, Duration, and EndTimevalues from the appointment, so you do not need to set them. If you do set these values, your settings override the Appointment settings. If you set all three properties: StartTime, Duration, and EndTime, Outlook Mobile ignores the Durationsetting and defines the Appointment with the StartTimeand EndTimesettings. If you set any two of these properties and leave the third property undefined, then Outlook Mobile calculates the undefined setting from the other two properties.

To set the start date of an IRecurrencePatternobject, use the PatternStartDateproperty. For Appointments, the Durationproperty of an IRecurrencePatternobject cannot be longer than 31 days. Furthermore, the minimum period between instances of a recurring appointment cannot be less than the duration of the appointment. Otherwise, appointment instances would overlap.

Requirements

Header pimstore.h
Library Pimstore.lib
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also