| Platform SDK: Exchange Server |
A gateway uses the MAPI-Recipient property (PR_SEND_RICH_INFO) to determine whether to backbone an individual message to a given recipient. The PR_SEND_RICH_INFO property is exposed in the recipient table of a message and denotes whether a recipient has a MAPI-capable system. If this property is TRUE for a recipient, the gateway should encapsulate Microsoft Exchange Server special properties in messages being backboned to that recipient.
The originator of a message can set whether a recipient is MAPI-capable on individual messages. This feature must be designed into the Addr-Type object and associated address entry template that you provide with your gateway. If the property is present on a recipient in a message, it will be stored in the personal address book (PAB) with an address. This MAPI-Recipient property is set in different ways for different object types, as described in the following sections.
The MAPI-Recipient attribute on the recipient object in the Microsoft Exchange Server directory is set by default to TRUE for mailbox objects and FALSE for custom recipient objects. The administrator can change the setting in the advanced property page for a particular user. This enables the administrator to specify that a particular recipient in a foreign system uses a MAPI-based client and that messages to that recipient should be encapsulated.
If directory replication is performed within an organization, you can also use this property to identify users who are in another site in the same organization. They are represented as mailbox objects in the directory and will have the property set to TRUE by default.
The directory of another Microsoft Exchange Server organization can be imported to the organization on which the gateway is configured. In this case, the mailbox objects in the original organization become custom recipient objects in the gateway’s organization. The MAPI-Recipient property of each original mailbox object retains its value of TRUE as a custom recipient object. The gateway can thus use the MAPI-Recipient property to determine whether messages to a recipient need to be backboned.
The MAPI-Recipient property may also be present on the originator of a message. A gateway should check for this and transfer the property to the Microsoft Exchange Server if it is present because the property will be needed if a recipient replies to a message and the gateway needs to return the reply to the originator.