Information about two new named property definitions that can control how a message is processed by Office Outlook 2003 when users reply to the message (915314)



The information in this article applies to:

  • Microsoft Office Outlook 2003

INTRODUCTION

This article describes two new named property definitions that message store developers can use together with the Account Management API to control how a message in their store is processed by Microsoft Office Outlook 2003 when users reply to the message.

MORE INFORMATION

The dispidInetAcctName property

The dispidInetAcctName named property is found on IMessage objects. The dispidInetAcctName property is a string type (PT_STRING8 or PT_UNICODE) and contains the display name of the account that delivered the message. This property should contain the same value that is returned from the Account Management API property PROP_ACCT_NAME for the account that delivered the message.

The dispidInetAcctStamp property

The dispidInetAcctStamp named property is found on IMessage objects. The dispidInetAcctStamp property is a string type (PT_STRING8 or PT_UNICODE) and contains the account stamp of the account that delivered the message. This property should contain the same value that is returned from the Account Management API property PROP_ACCT_STAMP for the account that delivered the message.

Use these properties

Message store providers can control some behavior of messages in your message store by following these steps:
  1. Expose these named properties on IMessage objects in the message store.
  2. Supply the appropriate values.
If message store providers expose these named properties, the following behavior occurs:
  • A user clicks Reply to All in an e-mail message. The e-mail address that is associated with the account and is stamped on the message is removed from the recipient list of the reply. This behavior occurs unless this e-mail address is the sender of the original message.
  • By default, replies and forwarded messages will be sent through the account that is stamped on the original message.
To expose these named properties correctly, message store providers should expect Outlook to call the GetIDsFromNames function together with MAPINAMEID structures that have the following information.

Note See the "Constants" section for the actual values.
lpGuid = PSETID_Common;
ulKind = MNID_ID;
Kind.lID = dispidInetAcctName;

lpGuid = PSETID_Common;
ulKind = MNID_ID;
Kind.lID = dispidInetAcctStamp;
When the Outlook Protocol Manager delivers messages, Outlook sets the dispidInetAcctName and dispidInetAcctStamp properties to indicate the account that delivered the message. However, if a message store is tightly coupled with a transport, the Outlook Protocol Manager does not deliver messages. Therefore, the properties are not stamped. In this scenario, the message store provider returns property tags by using the GetIDsFromNames function. When Outlook calls the IMAPIProp::GetProps method by using these property tags, the message store provider can return the account name and stamp of the desired account.

Note Outlook Protocol Manager is the replacement for the MAPI Spooler.

Constants

DEFINE_OLEGUID(PSETID_Common, MAKELONG(0x2000+(8),0x0006),0,0);

#define dispidInetAcctName 0x8580
#define dispidInetAcctStamp 0x8581

REFERENCES

For more information about the Outlook Account Management API, visit the following Microsoft Developer Network (MSDN) Web site:

Modification Type:MajorLast Reviewed:3/8/2006
Keywords:kbMsg kbinfo KB915314 kbAudDeveloper