Become a Columnist |  Microsoft Exchange Site | Microsoft Support Site | MSDN Exchange Site

Subscribe to OutlookExchange What's New Columnist Anderson Patricio Ann Mc Donough Bob Spurzem Brian Veal Catherine Creary Cherry Beado Colin Janssen Collins Timothy Mutesaria Drew Nicholson Fred Volking Glen Scales Goran Husman Guy Thomas Henrik Walther Jason Sherry Jayme Bowers John Young Joyce Tang Justin Braun Konstantin Zheludev Kristina Waters Kuang Zhang Mahmoud Magdy Martin Tuip Michael Dong Michele Deo Mitch Tulloch Nicolas Blank Pavel Nagaev Ragnar Harper Ricardo Silva Richard Wakeman Russ Iuliano Santhosh Hanumanthappa Steve Bryant Steve Craig Todd Walker Tracey J. Rosenblath Development Microsoft Scripting Center Code Example Page Outlook Object Model Constants More Resources White Papers Microsoft Sites Documentation Help Files Sample Apps Tools & Addons Books Other Sites FAQ's Programming With Outlook Slipstick Systems Other Sites of Interest Software Exchange Server Downloads Other Links Exchange Training Exchange/Outlook FAQs

Outlook Object Model Page White Papers   The Outlook 98 Object Model Graphics By Randy Byrne The Microsoft Outlook 97 Automation Server Programming Model By Randy Byrne Microsoft Outlook Objects from the Microsoft Office 97/Visual Basic Programmer's Guide Object Model Maps   Outlook Object Model Extended View Courtesy of Randy Byrne Outlook Object Model Main View Courtesy of Randy Byrne Outlook Object Model Legend Courtesy of Randy Byrne Object Model Downloadable Images   Download Visio version of Outlook 2000 Object Model Map (542k) Download Visio version of Object Model Map (608k) Download Windows Metafile version of Object Model Map (10k) Download Encapsulated Postscript version of Object Model Map (44k) Outlook Item Objects Outlook items are represented by the fundamental objects in the Outlook object model. These objects represent mail messages, appointments or meetings, meeting requests, tasks, task requests, contacts, journal entries, posts, mail delivery reports, remote mail items, and notes. The following table describes the objects that represent Outlook items.   Object Description AppointmentItem Represents an appointment in the Calendar folder. An AppointmentItem object can represent either a one-time or recurring meeting or appointment. An appointment becomes a meeting when the MeetingStatus property is set to olMeeting and one or more resources (either personnel, in the form of required or optional attendees, or physical resources, such as a conference room) are designated. These actions result in the creation of a MeetingRequestItem object. ContactItem Represents a contact in a Contacts folder. A contact can represent any person with whom you have any personal or professional contact. JournalItem Represents a journal entry in a Journal folder. A journal entry represents a record of all Outlook-moderated transactions for any given period of time. MailItem Represents a mail message in the Inbox folder or another mail folder. The MailItem object is the default item object and, to some extent, the basic element of Outlook. In addition to the MailItem object, Outlook also has a parallel PostItem object that has all of the characteristics of the mail message, differing only in that it's posted (written directly to a folder) rather than sent (mailed to a recipient), and it has two subordinate objects - RemoteItem and ReportItem objects - that are subsets of the mail message used to handle remote mail items and mail transport system reports, respectively. MeetingRequestItem Represents a change to the recipient's Calendar folder, initiated either by another party or as a result of a group action. Unlike with other Outlook objects, you cannot create a MeetingRequestItem object or find an existing one in the Items collection. This object is created automatically when you set the MeetingStatus property of an AppointmentItem object to olMeeting and send it to one or more users. To return the AppointmentItem object associated with a MeetingRequestItem object and work directly with the AppointmentItem object to respond to the request, use the GetAssociatedAppointment method. NoteItem Represents a note (an annotation attached to a document) in a Notes folder. PostItem Represents a post in a public folder that other users can browse. This object is similar to the MailItem object, differing only in that it's posted (saved) directly to the target public folder, not sent (mailed) to a recipient. You use the Post method, which is analogous to the Send method for the MailItem object, to save the post to the target public folder instead of mailing it. RemoteItem Represents a remote item in the Inbox folder or another mail folder. This object is similar to the MailItem object, but it contains only the Subject, Received, Date, Time, Sender, and Size properties and the first 256 characters of the body of the message. You use it to give someone who's connecting in remote mode enough information to decide whether or not to download the corresponding mail message. ReportItem Represents a mail-delivery report in the Inbox folder or another mail folder. This object is similar to the MailItem object, and it contains a report (usually the nondelivery report) or error message from the mail transport system. TaskItem Represents a task (an assigned, delegated, or self-imposed task to be performed within a specified time frame) in a Tasks folder. Like appointments or meetings, tasks can be delegated. Tasks are delegated when you assign them to one or more delegates, using the Assign method. TaskRequestItem Represents a change to the recipient's task list, initiated either by another party or as a result of a group assignment. Unlike with other Outlook objects, you cannot create a TaskRequestItem object or find an existing one in the Items collection. It's created automatically when you apply the Assign method to a TaskItem object to assign (delegate) the associated task to another user. To return the TaskRequestItem object and work directly with the TaskItem object to respond to the request, use the GetAssociatedTask method. The following table provides a quick summary of Outlook item objects and their default MAPIFolder containers. Note that the MeetingRequestItem, OfficeDocumentItem, RemoteItem, ReportItem, and TaskRequestItem objects cannot be created programmatically. MeetingRequestItem and TaskRequestItem are related to their associated AppointmentItem and TaskItem objects through the GetAssociatedAppointment and GetAssociatedTask methods.   Object Name Message Class Default Folder Createable by Automation AppointmentItem IPM.Appointment Calendar Yes ContactItem IPM.Contact Contacts Yes JournalItem IPM.Activity Journal Yes MailItem IPM.Note Inbox Yes MeetingRequestItem IPM.Schedule.Meeting.Request Note: Can vary upon response such as IPM.Schedule.Meeting.Resp.Pos -- Or -- IPM.Schedule.Meeting.Resp.Neg Inbox No NoteItem IPM.StickyNote Notes Yes OfficeDocumentItem Note: OfficeDocumentItem is a hidden class in msoutl8.olb IPM.Document.[ClassID] Example: IPM.Document.Office.Binder.8.My Form N/A Usually in public folders Only if a custom form has been created. PostItem IPM.Post N/A Usually in public folders Yes RemoteItem IPM.Remote Inbox No ReportItem IPM.Report Inbox No TaskItem IPM.Task Tasks Yes TaskRequestItem IPM.TaskRequest Note: Can vary upon response such as IPM.TaskRequest.Accept -- Or -- IPM.TaskRequest.Decline Inbox No

Disclaimer: Your use of the information contained in these pages is at your sole risk. All information on these pages is provided "as is", without any warranty, whether express or implied, of its accuracy, completeness, fitness for a particular purpose, title or non-infringement, and none of the third-party products or information mentioned in the work are authored, recommended, supported or guaranteed by Stephen Bryant or Pro Exchange. OutlookExchange.Com, Stephen Bryant and Pro Exchange shall not be liable for any damages you may sustain by using this information, whether direct, indirect, special, incidental or consequential, even if it has been advised of the possibility of such damages.

Copyright Stephen Bryant 2008