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

• IUnknown methods
• IDispatch methods

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