IRecurrencePattern::put_Instance

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

The Instance property gets or 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.

To set the value of the Instance property, call the property method described here.

To get the value of the Instance property, see the IRecurrencePattern::get_Instance property method.

Syntax

HRESULT put_Instance(
  long lInstance
);

Parameters

  • lInstance
    [in] An integer value indicating the day of the week, the week of the month, or the month of the year in which the recurrence pattern occurs.

Return Value

This method returns the standard values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, and E_FAIL, as well as the following:

  • S_OK
    The method completed successfully.

Remarks

Valid for OlRecurrenceType enumeration recurrence types olRecursMonthNth, and olRecursYearNth.

For a recurrence type of olRecursMonthNth, pIInstance is a reference to an integer value between 1 and 5, inclusive, that represents a recurrence pattern expressed as a week of the month. In this case, the value five always represents the last week of the month.

You must set the RecurrenceType property before setting this property.

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

Tasks

Creating a Recurring Appointment

Reference

IRecurrencePattern::get_Instance
Pocket Outlook Object Model Interfaces

Other Resources