IException (Compact 7)

3/12/2014

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

See Also

Reference

Pocket Outlook Object Model Interfaces
IExceptions
Pocket Outlook Object Model Enumerations