dispidHeaderItem

dispidHeaderItem

Specifies whether Microsoft Office Outlook has downloaded to the client computer only the header of a message, or both the header and body of the message, when Outlook is configured in Cached Exchange Mode.

Quick Info

Exposed on: Message objects
Created by: Outlook
Accessed by: Outlook and solution providers
Property type: PT_LONG
Access type: Read/write

Remarks

To retrieve the value of this property, first use IMAPIProp::GetIDsFromNames to obtain the property tag, and then specify this property tag in IMAPIProp::GetProps to get the value. When calling IMAPIProp::GetIDsFromNames, specify the following values for the MAPINAMEID structure pointed at by the input parameter lppPropNames:

lpGuid: PSETID_Common
ulKind: MNID_ID
Kind.lID: dispidHeaderItem

This property returns a non-zero value when only the header of the message has been downloaded. It returns zero when both the header and the body have been downloaded.

If Outlook is configured to connect to an IMAP mail server, use IProxyStoreObject. For more information, see How to: Access a Message on an IMAP Store Without Downloading the Entire Message.

See Also

Constants for Outlook Named Properties

KB 912239: How to use the dispidHeaderItem MAPI property to identify the state of a message that you receive in Outlook 2003

How to: Determine if Outlook Downloaded Only the Header of a Message