How do I handle MFCMapi and what do I need the tool for? – C4B Support

Question:

How do I handle MFCMapi and what do I need the tool for?

Explanation:

The MFCMapi (Microsoft Foundation Classes MAPI) tool is a Microsoft Exchange Server MAPI editor, hex editor and debug viewer. We use this primarily to determine if misbehavior is occurring with connected Outlook contacts / server-side calendar synchronization independent of XPhone.

Usage:

The tool MFCMapi.exe can be found in the download package of the XPhone Connect Server (release DVD) in the directory \Tools\MFCMapi

The tool must be started in the context of the MAPI account which is also used as service account for XPhone Server. Log on to the XPhone Connect Server in Windows with this MAPI account. Then start the MFCMapi Tool in this context.

Then click on Session > Logon...

and then select the profile under which the services are also running.

Check the functionality of the profile:

Log on to the MFCMapi Tool as described in Usage.

If the profile is functional, the folders can be opened by double-clicking and the entries present there can be displayed.

In order to rule out rights problems when accessing the contact folder, it is essential that you open the contact folder to the extent that the existing entries are actually displayed. The MAPI account must therefore have at least one personal contact in its contact folder!

Open the mailbox of another user:

This test is necessary if you want to connect private Outlook contact folders, or if you want to use the server-side calendar synchronization.

1. log in to MFCMapi as described under Usage.

2. Select the menu item MDB > Open other mailboxes > From GAL...

3. If the following dialog appears, please enter the Exchange Server of the customer.

4. select a user from whom the contacts / calendars should be seen and confirm with OK.

5. a dialog should open as follows.

6. then confirm with Enter and a new dialog opens with the mailbox you have selected. If the left green marked area is filled, the access can be evaluated as successful.

Troubleshooting rights problems

If the attempt to open the foreign mailbox fails with a rights problem, you can try different combinations of the flags and enter them at "CreateStoreEntryID flags":

The following three flags are relevant, which can be combined by adding their values:

OPENSTORE_USE_ADMIN_PRIVILEGE = 0x1
OPENSTORE_HOME_LOGON = 0x4
OPENSTORE_TAKE_OWNERSHIP = 0x8

"TAKE_OWNERSHIP" is always required and must be included in every combination.

XPhone Connect uses the flag combination: "HOME_LOGON" + "TAKE_OWNERSHIP" by default.

This would result in 12 or 0xC in hexadecimal. Enter the value 12 like this 0x0000000c

The MFCMapi default is "USE_ADMIN_PRIVILEGE" and "TAKE_OWNERSHIP" = 9, so 0x00000009
If the XPhone Connect default (0x0000000c) does not work and you have found a working combination that does not match the XPhone Connect default, you can enter the numeric value in atlas.xml (XPhone Connect Server Manager > Tools > atlas.xml) to override the XPhone Connect default.

After customization, the file must be saved and XPhone Connect Server must be restarted.

ATTENTION: Changes in the atlas.xml should only be made by experienced partners. In case of a syntax error or similar, it may happen that the server can no longer be started or other errors occur.

Check AutoDiscover

In older MAPI versions, setting the home server in combination with some flags was sufficient. In the meantime there is an automatic, independent configuration via the Exchange Server, the so called AutoDiscover.

The Exchange Server updates the AutoDiscover server, which then returns the correct location of the mailbox to Outlook or the MAPI client.

To check the AutoDiscover service, do the following.

1. start Outlook.

2. open the context menu in the SysTray on the Outlook icon by the combination "Ctrl" + right mouse button.

3. In the context menu select the command "Test E-Mail AutoConfiguration ...".

4. Click the "Test" button in the dialog. If the AutoDiscover works, an output like below is generated.

5. the Exchange administrator at the customer's site can check the output for plausibility.

If with MFCMapi all tests were successful and there are still difficulties, check if necessary also the points of the following article: https://support.c4b.de/hc/en-150/articles/5664571178396