This documentation is archived and is not being maintained.

What's New in This Edition

Office 2007

This topic describes what is new in the current edition of the Microsoft Office Outlook 2007 Auxiliary Reference. The earlier version of this reference is the Microsoft Office Outlook 2003 Integration API Reference.

Attachment Security API

Feature AreaDescriptionRelated Topics
Attachment blockingUse IAttachmentSecurity::IsAttachmentBlocked to verify whether Outlook blocks a specified attachment for viewing and indexing.

Indexing Stores for Search

Feature AreaDescriptionRelated Topics
Registering stores for indexingHow to register stores for the MAPI Protocol Handler to index.
Notification-based indexingHow store providers can use the STORE_PUSHER_OK flag to indicate to the MAPI Protocol Handler to index only when notified, and how to send such notifications.

Mail Envelope API

The Mail Envelope API enables users on a MAPI mail client to interface with applications in the 2007 Office system and to send Office documents. Note that this API is supported by Microsoft Office Outlook 2007 only and will be deprecated in future releases.

MAPI Additional Documentation

Numerous MAPI properties, constants, data types and functions have been added to this release. For an overview of these additions, such as general properties of message objects and properties of messaging user objects for Unicode support, see About MAPI Additions. The following table highlights some of these additions.

Feature AreasDescriptionRelated Topics
Address BookProperties contain the Address Book location in online and offline scenarios.
Address Book entryUse the DIALOG_MODAL flag in IAddrBook::Details to display the address book entry in a modal dialog box.
Address Book entry, Store cachingUse the MAPI_CACHE_ONLY flag to open an Address Book entry and to subsequently access it only from the cache.
Background processingUse the MAPI_BG_SESSION flag to log on to a MAPI session for any processing that is intended to be unobtrusive and stay in the background.
Contact photographAttach a picture of a contact to the underlying messaging user object.
Exchange Server connectionProperty contains the profile settings to connect Outlook to Microsoft Exchange Server using a remote procedure call (RPC) over Hypertext Transfer Protocol (HTTP).
Exchange Server versioningDetect the version of Exchange Server that is connected to the active account.
MAPI versioningRestore mapi32.dll.
Message agingSpecify the length of time that a message remains in a folder before it is archived.
Message encodingSpecify an Internet encoding scheme for the Exchange Internet Mail Service (IMS) to encode the body and attachments of a message.
Message encodingThere are several ways to specify whether TNEF or plain text should be used when converting an outgoing MAPI message to MIME format.
Name resolutionSet the order of address lists by which recipients in e-mail messages and attendees in meeting requests are resolved.
Outlook user interfaceAppropriately display an Address Book entry depending on its type and whether it is local, remote, or security-controlled.
Outlook user interfaceDisplay the name and icon for the MAPI provider in the Outlook status bar.
Outlook special foldersIdentify Outlook special folders, such as the Calendar folder and Contacts folder, by their entry IDs that are stored in the Inbox folder and root folder of the message store.
Spam filteringUse the SPAMFILTER_ONSAVE flag to enable spam filtering on a message that is being saved.
Store cachingIf the client is in Cached Exchange Mode, use the IID_IMessageRaw GUID symbolic name to request an IMessage interface for a message with only the header in the cache, without forcing a download from the server for the entire message.
Store cachingIf the client is in Cached Exchange Mode, use the MAPI_NO_CACHE flag to open an item or folder on the remote store that has been opened in cached mode, and subsequently access the item or folder directly from the remote store.
Store cachingIf the client is in Cached Exchange Mode, use the MDB_ONLINE flag to open a non-default store on a remote server.
Unicode supportUse the MAPI_UNICODE flag to create and open a new message file (.msg) that supports Unicode properties.
Unicode supportUse the STORE_UNICODE_OK flag in the PR_STORE_SUPPORT_MASK property to indicate the store supports Unicode storage.

MAPI Configuration

Feature AreaDescriptionRelated Topics
MAPI versioningLoad and dispatch calls to a specific version of MAPI.
MAPI versioningRestore mapi32.dll.

Named Properties in Outlook

Feature AreaDescriptionRelated Topics
Cached Exchange ModeVerify whether Outlook has downloaded only the header of a message in Cached Exchange Mode.
Custom formsRemove custom form definition that has been saved with a message.
Meeting items in the Outlook object modelIdentify a meeting item as a counter-proposal to an earlier meeting request by using the Outlook object model.
Message objects representing tasksMiscellaneous named properties for task items.See the list under the PSETID_Task namespace in About Named Properties Used by Outlook.
Message objects used for logging journalsMiscellaneous named properties for journal items.See the list under the PSETID_Log namespace in About Named Properties Used by Outlook.
Message objects used for schedulingMiscellaneous named properties for appointment items and meeting request items.See the list under the PSETID_Appointment namespace in About Named Properties Used by Outlook.
Message objects used for schedulingVerify the update status of a meeting request item.
Message objects representing contactsMiscellaneous named properties for contact items.See the list under the PSETID_Address namespace in About Named Properties Used by Outlook.
Message objects representing contactsObtain information for a contact given the corresponding entry in the Contacts Address Book.
Message objects representing contactsObtain the primary e-mail address of an Outlook contact item.
Spam filterOutlook avoids moving the same e-mail to the Junk E-mail folder again after a user has identified the e-mail as a non-spam message.

Outlook Configuration

Outlook Exported APIs

Feature AreaDescriptionRelated Topics
Exchange ServerAuto-discovery of Microsoft Exchange Server 2007.
Exchange ServerVerify whether Cached Exchange Mode is enabled and enforced by Group Policy.
Exchange ServerVerify PST and OST shared memory is in a consistent state and move the data to disk.
MessagesDecompress the body of a message that is in compressed RTF mode and optionally convert it to the native format.

Sample Service Providers

The Outlook 2007 Auxiliary Reference includes three sample service providers: an address book provider, a message store provider, and a transport provider. The sample message store provider is a wrapped personal store that is intended to work with the Replication API. For more information about these samples, see About the Sample Address Book Provider, About the Sample Wrapped PST Store Provider, and About the Sample Transport Provider. To download the code samples for these sample service providers, see Outlook 2007 Auxiliary Reference Code Samples and Redistributable Installer.

Sample Offline State Add-in

The Sample Offline State Add-in is a COM add-in that adds an Offline State menu to Outlook and uses the Offline State API. Through the Offline State menu you can enable or disable state monitoring, check the current state, and change the current state. For more information, see About the Sample Offline State Add-in. To download the code sample, see Outlook 2007 Auxiliary Reference Code Samples and Redistributable Installer.

How-to Code Samples

The Outlook 2007 Auxiliary Reference provides code examples that demonstrate how to do some common tasks.

Enhancements to Existing APIs

For the following APIs that are documented in earlier releases of the Outlook Integration API Reference, in the Outlook 2007 Auxiliary Reference, new members have been added and earlier issues have been fixed.

The next sections list the new APIs that have been added.

Account Management API

Additions to the Account Management API include the following:

Feature AreaDescriptionRelated Topics
Account informationProperties that contain the name and stamp of the account that delivered a message.
Account informationProperties that contain the entry ID for the default delivery folder, default delivery store, and default folder for sent items of an account.
Account supportDetermine the capability of an account so that Outlook can disable the appropriate user interface elements.
Outlook user interfaceSpecify a store as the default delivery store for an account will list the store in the To-Do Bar.

MAPI-MIME Conversion API

Additions to the MAPI-MIME Conversion API include the following:

Feature AreaDescriptionRelated Topics
Custom character setSpecify a character set for MAPI-to-MIME conversion.
Name resolutionSpecify a MAPI address book for MAPI-to-MIME conversion.
New actionsNew flags CCSF_USE_TNEF, CCSF_8BITHEADERS, and CCSF_PLAIN_TEXT_ONLY for MAPI-to-MIME conversion.
Transport Neutral Encapsulation Format (TNEF) supportThere are several ways to specify whether TNEF or plain text should be used when converting an outgoing MAPI message to MIME format.

Replication API and Sample Store Provider for Wrapped PST Store

Additions to the Replication API include the following:

Feature AreaDescriptionRelated Topics
Error conditionGet extended information about the last error when replicating data between the server and the local store.
Sample provider for a wrapped Personal Folders (PST) storeThis code sample provides a starting point to develop a wrapped PST store provider that can utilize the Replication API to synchronize data between the server and the local PST store.

Store API

Additions to the Store API include the following:

Feature AreaDescriptionRelated Topics
Identifying foldersProperty contains multiple values that are mapped to entry IDs of specific folders if they exist on the store.
Scanning foldersProperties that specify whether certain folders on a store can be scanned.
Store accessObtain access to a personal store without invoking synchronization.
Store searchingProperties that contain IDs for folders and items, that persist between sessions and are used for identifying search results.
Store searchingProperties that contain specific strings for querying in messages.
Store supportVerify a folder's support for sharing.
Store supportVerify how a store supports restrictions, and if a non-default store can support folder home pages.