Export (0) Print
Expand All

IPOutlookItemCollection::put_IncludeRecurrences

Windows Mobile 6.5
A version of this page is also available for
4/8/2010

The IncludeRecurrences property gets and sets a value that indicates whether to include Appointment recurrence instances in a collection of Appointment items (sorted on the IAppointment::get_Start property, in ascending order).

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

To get the value of the IncludeRecurrences property, see the IPOutlookItemCollection::get_IncludeRecurrences property method.


HRESULT put_IncludeRecurrences(
   VARIANT_BOOL fIncludeRecurrences
);

fIncludeRecurrences

[in] Reference to a Boolean flag. VARIANT_TRUE if Appointment recurrence instances are included. For information about the VARIANT_BOOL type, see the union member of the PROPVARIANT structure.

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.

If VARIANT_TRUE, recurring Appointments are expanded to all dates upon which they occur. If VARIANT_FALSE (the default), recurring Appointments are only associated with the first day upon which they occur.

Set this property to VARIANT_TRUE when you want to find all Appointments that fall on a specific date.

The VARIANT_BOOL data type (also known as VT_BOOL) uses the value -1 to represent TRUE and 0 to represent FALSE. It is defined in the wtypes.h header file in the following manner:

typedef short VARIANT_BOOL;

A common programming error occurs when, for readability purposes, you want to set a VARIANT_BOOL value to TRUE or FALSE. You can achieve the same effect by using the aliases VARIANT_TRUE and VARIANT_FALSE, which are also defined in the wtypes.h header file.

#define VARIANT_TRUE  ((VARIANT_BOOL)0xffff)
#define VARIANT_FALSE ((VARIANT_BOOL)0)

Headerpimstore.h
LibraryPimstore.lib
Windows Embedded CEWindows CE 2.0 and later
Windows MobileWindows Mobile Version 5.0 and later

Community Additions

ADD
Show:
© 2014 Microsoft