IExceptions::Item
This method is not supported in Windows CE Platform Builder 3.0.
This method gets an exception from the exceptions collection for a recurring appointment.
HRESULT Item( int iIndex, IException ** ppException );
Parameters
- iIndex
[in] The one-based index for an exception. - ppException
[out] Pointer to a pointer to the exception.
Return Values
S_OK indicates success. If an error occurs, the appropriate HRESULT value is returned.
Remarks
An exception object is created when a recurring appointment item is altered. For example, if you change the Start property of one instance of a recurring appointment, you create an exception in the exceptions collection for the recurrence pattern.
The IExceptions collection is on the IRecurrencePattern object, not on the IAppointment item itself. The IExceptions object can be accessed with the get_Exceptions property method of the IRecurrencePattern object.
Code Example
The following C++ code snippet gets the first exception item in the Exceptions collection of a recurring appointment:
void GetFirstExceptionItem(IAppointment *pAppt)
{
IRecurrencePattern *pRec;
IExceptions *pExceptions;
IException *pException;
// Get the exception item
pAppt->GetRecurrencePattern(&pRec);
pRec->get_Exceptions(&pExceptions);
pExceptions->Item(1, &pException);
// Release objects
pRec->Release();
pExceptions->Release();
pException->Release();
}
Requirements
| Runs On | Versions | Defined in | Include | Link to |
|---|---|---|---|---|
| Windows CE OS | 2.0 and later | pimstore.h |
See Also
IExceptions::Unknown, IExceptions::Property Methods
Last updated on Tuesday, July 13, 2004
© 1992-2000 Microsoft Corporation. All rights reserved.