Using the Message Store Viewer

The message store viewer (MDBVU32.EXE) is a MAPI client application that helps you debug your application by providing a view of information in a mailbox or any other object in an information store. This application displays the following information:

• A message or any other object in the exact format you will use in your application.
• A message as a set of properties and a collection of calls that can be performed on that object.
• A log of each MAPI action that has been performed against this object.
• Nested elements, such as attachments, and allows you to view them separately.

The message store viewer can be used to set and change properties, as well as view them. This is useful if you are writing a message-processing application. The message store viewer shows which properties are available on each message, how you can use them, and in what format they will appear.

The message store viewer can also be used to debug messages. If you can successfully save a message but submitting it fails, you can save the message and look at all its properties with the message store viewer. This is far more efficient than writing code to dump the message's properties.

Displaying a Folder Using the Message Store Viewer

Follow these steps from the message store viewer menu to display a folder in a mailbox. The example displays the root folder of a gateway's mailbox:

To display a folder using the message store viewer

1. From the Session menu, choose MAPILogonEx if this option has not been chosen for you automatically.
2. Choose Profile. Unless you specified the MAPI_NEW_SESSION flag, select the profile your application uses to log on. If you are already logged on, this step is unnecessary.
3. From the MDB menu, choose OpenMessageStore. Use this option to select the store provider to be opened from among those configured in your profile. Although a user's profile may contain the public store, the private store, and zero or more personal folders, only one choice may be available for a server application that uses only the Microsoft Exchange Server private server. Choose Open from the Public Folders menu to view the public information store.
4. From the MDB menu, choose Open Root Folder or Open IPM Subtree. The Open IPM Subtree option is not available for gateways because a gateway object does not contain an IPM Subtree. Once you have opened the Root Folder, a screen such as the following is displayed:

View of a gateway's root folder using the message store viewer

The preceding screen shows the root folder of a gateway's mailbox. You can now view the contents of other folders in the gateway's mailbox. For example, to view the gateway's inbox, double-click MTS-IN in the Child Folders list box.

The Properties window shows which properties are set on the object. At the top of the Properties window, you may see properties that are numbered instead of labeled with property tags. These properties are customized by each provider, which in this case is the Microsoft Exchange Server store provider. Look in the header file for specific information on these properties. Custom properties for the Microsoft Exchange Server information store are defined in the EDKMDB.H file. Custom properties for the Microsoft Exchange Server directory are defined in the EMSABTAG.H file. Standard MAPI properties are identified by name rather than number.

If you're processing messages, the message store viewer displays the message's exact appearance and properties. For instance, the utility will show you that a delivery report or nondelivery report differ in appearance and, therefore, have a different set of properties than a regular message.