IException

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

The IException interface contains information about a single exception to a recurring Appointment. The properties are read-only. You can use the IRecurrencePattern::get_Occurrences method to create and manipulate an exception objects.

Methods in Vtable Order

IException methods Description

IException::get_AppointmentItem

Gets the Appointment item that corresponds to this exception.

IException::get_OriginalDate

Gets the date that this exception originally occurred.

IException::get_Deleted

Returns TRUE if the exception was caused by a deleted instance.

IException::get_Application

Gets the main Outlook Mobile IPOutlookApp object.

Remarks

An IException object is created when you alter a recurring Appointment. For example, an exception is created when you change the Start property of an Appointment item.

You get an exception by first calling the IRecurrencePattern::get_Exceptions method, which returns Exceptions collection object, and then calling the IExceptions::Item method.

Code Example

The following code example gets the first exception item in the exceptions collection of a recurring Appointment.

Note

To make the following code example easier to read, security checking and error handling are not included. This code example should not be used in a release configuration unless it has been modified to include them.

void GetFirstExceptionItem(IAppointment * pAppt)
{
    IRecurrencePattern * pRec;
    IExceptions        * pExceptions;
    IException         * pException;

    // Get the Exception object.
    pAppt->GetRecurrencePattern(&pRec);
    pRec->get_Exceptions(&pExceptions);
    pExceptions->Item(1, &pException);

    // Free resources.
    pRec->Release();
    pExceptions->Release();
    pException->Release();
}

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

Reference

IExceptions
Pocket Outlook Object Model Interfaces

Other Resources

Pocket Outlook Object Model Enumerations