Platform SDK: MAPI

Advertising a Remote Transport

Remote viewer applications need a way to identify which transport providers support remote functionality. In order to advertise this ability to remote viewers, remote transport providers must set the STATUS_REMOTE_ACCESS bit in the PR_STATUS_CODE property and the STATUS_VALIDATE_STATE bit set in the PR_RESOURCE_METHODS property of the transport provider's row in the status table.

Remote transport providers must also include in the status row the PR_HEADER_FOLDER_ENTRYID property. This property indicates the entry identifier of the folder that is used for downloading by remote viewer applications. This entry identifier is registered with MAPI when the transport provider is initialized. When the user opens the folder, the remote viewer application calls the IMAPISession::OpenEntry method passing in the folder's entry identifier. MAPI then forwards the call to the transport provider which registered the folder's entry identifier. The transport should return a view of the contents of the folder. This folder's contents table should contain the list of messages in the folder.