ItemEvents_10_Event.AfterWrite Event

Occurs after Microsoft Outlook has saved the item.

Namespace:  Microsoft.Office.Interop.Outlook
Assembly:  Microsoft.Office.Interop.Outlook (in Microsoft.Office.Interop.Outlook.dll)

Syntax

'Declaration
Event AfterWrite As ItemEvents_10_AfterWriteEventHandler
'Usage
Dim instance As ItemEvents_10_Event
Dim handler As ItemEvents_10_AfterWriteEventHandler

AddHandler instance.AfterWrite, handler
event ItemEvents_10_AfterWriteEventHandler AfterWrite

Remarks

The AfterWrite event occurs after the Write event. This event is not cancelable. To determine when the item is unloaded from memory, use the Unload event.

The AfterWrite event corresponds to the Exchange Client Extensions (ECE) event IExchExtMessageEvents::OnWriteComplete.

Only the following members of the item object can be accessed in the AfterWrite event:

  • Class

  • MessageClass

  • MAPIOBJECT

The MAPIOBJECT property is a hidden property in the Outlook object model. This property provides access to the underlying MAPI IMessage object, and can be invoked only via the IUnknown interface. The property is accessible to programs written in languages such as C or C++ that support IUnknown. MAPIOBJECT is not available through the IDispatch interface. Development languages such as Visual Basic for Applications (VBA), Visual C#, and Visual Basic support the IDispatch interface and not IUnknown, and therefore, they cannot access MAPIOBJECT. If other properties or methods of the parent item are accessed in this event, Outlook raises an error.

The object obtained from the MAPIOBJECT property in this event must contain all the changes persisted by Outlook. The implementer can call the SaveChanges method on the IMessage object to persist changes to the underlying IMessage object represented by MAPIOBJECT, and Outlook will not revert those changes.

Implementers must release the object obtained from the MAPIOBJECT property in the event before the event completes. Attempting to use that object outside the context of the event is unsupported and will lead to unpredictable behavior.

See Also

Reference

ItemEvents_10_Event Interface

ItemEvents_10_Event Members

Microsoft.Office.Interop.Outlook Namespace