MBXSERV: Viewing Messages in a Mailbox

The MBXSERV sample application demonstrates how to create a property page attached to mailboxes that allows you to view the titles of all the messages in the mailbox, using a password for security. It can be used as an example of one component in a voice mail server application. For more information on this topic, see How a Voice Mail Server Works.

MBXADMIN.DLL is an Administrator program extension that adds a property page to a mailbox's property sheet. To use it, the Administrator extension DLL must be installed with EXTNINST: Installing an Administrator Extension installation program. After installation, MBXADMIN must be attached to the mailboxes, which adds the MBX Sample property page to the property sheets of all the mailboxes. To view the titles of all the messages in the mailbox, a user must run the MBXSERV application and access the mailbox by typing a password. For more information about installing the extension DLL, see Installing the Administrator Extension DLL. For general information about Administrator extensions, see Administrator Program Extensions.

    To build MBXSERV
  1. Change to the directory containing the MBXSERV source files:

    \BKOFFICE\SAMPLES\EXCHANGE\MBXSERV

  2. Compile MBXSERV by typing NMAKE.
  3. Change to the directory containing the MBXADMIN.DLL Administrator extension DLL source files:

    \BKOFFICE\SAMPLES\EXCHANGE\MBXADMIN

  4. Compile MBXADMIN.DLL by typing NMAKE.

    Install the Administrator extension DLL by using the compiled EXTNINST sample application found in the \EXCHSDK\BIN directory.

    To install MBXAdmin using EXTNINST
  1. Copy the Administrator extension DLL (MBXADMIN.DLL) to the appropriate ADD-INS directory on the Microsoft Exchange Server computer. Each server has a top-level shared directory called \\<server name>\ADD_INS. The directory path is composed of the path to the ADD-INS directory, a directory called MBX, and a directory whose name matches the computer type. For example:

    CD C:\EXCHSRVR\ADD-INS

    MD MBX

    CD MBX

    MD I386

    CD I386

    COPY C:\BKOFFICE\SAMPLES\EXCHANGE\MBXADMIN\WIN32\<build type>\MBXAdmin.DLL

  2. To use EXTNINST to install the mailbox, type a command similar to the following:

    EXTNINST /SITEDN=/O=MICROSOFT/OU=EDKUE DISPLAY_NAME=MBX /MACHINE=I386 /NAME=MBX /EXTDLL=C:\EXCHSRVR\ADD-INS\MBX\I386\MBXADMIN.DLL /SERVER=EDKDOCS20

    You should receive the message:

    Admin Extension installed successfully
     
  3. Verify that the Administrator extension has been installed by checking the Add-Ins container within the Configuration container in the Administrator program. You should see an icon for the Administrator extension DLL.
  4. Start the Administrator program using the /RAW switch.
  5. Select the Recipients directory object in the left pane, and then choose the Raw Properties option from the File menu.
  6. Check All in the List Attributes of Type box.
  7. In the Object Attributes list box, click the Extension-Name-Inherited property.
  8. In the Edit Value text box, type your object's name with the /NAME parameter. For example: MBX
  9. Click Add and then click OK.

    Once MBXAdmin is installed, you can view the new property page called MBX Sample on any mailbox property sheet. You must enter and then use a password to view the messages from any mailbox.

  10. Enable a password. To do this, double-click on the mailbox containing the messages you want to view. Select the MBX Sample property page. Type the password in the Password and Verify Password fields. This password need not be the same as the account password.