HOWTO: Debug the Sample Gateway Conversion DLLs

ID: Q234357


The information in this article applies to:
  • Exchange Development Kit (EDK), versions 5.0, 5.5


SUMMARY

This article explains how to setup the environment to debug the EDK sample gateway conversion DLLs: IPM_IN.dll and IPM_OUT.dll. This allows you to step through the conversion dll's source code.


MORE INFORMATION

The prerequisites for this article are:

  1. The sample gateway is installed.
    For more information on installing the sample gateway see:
    Q200669 HOWTO: Install the Sample Gateway in Exchange Development Kit


  2. You have debugged the sample by using the following steps:
    Q199087 HOWTO: Debug the Sample Gateway as a Console Application


Use the following steps to setup up the environment to debug the EDK sample gateway conversion DLLs:
  • Build the debug versions and symbols for the two DLLs: IPM_IN.dll and IPM_OUT.dll. These projects can be found at:

    • \MSSDK\samples\dbmsg\exchange\IPM_IN\IPM_IN.dsp
    • \MSSDK\samples\dbmsg\exchange\IPM_OUT\IPM_OUT.dsp

    You can use Microsoft Visual C++ to build the debug versions and symbols. In each project, select Build -> Set Active Configuration and pick the Win32 Debug configuration. Then, go to Project -> Settings -> Link and select "Generate debug Information". Now, build the project by selecting Build -> Batch Build, select the Win32 Debug build and click Build.


  • Copy IPM_IN.dll, IPM_IN.pdb, IPM_OUT.ddl and IPM_OUT.pdb from the respective debug directories to the WinNT/system32 directory.


  • In Microsoft Visual C++, open the sample gateway project you made in
    Q199087 HOWTO: Debug the Sample Gateway as a Console Application


  • Select Project -> Settings -> Debug and select Additional DLLs from the Category list. Now, add IPM_IN.dll and IPM_OUT.dll to the list of modules.


  • From the File menu select "Open", to open the IPM_IN and IPM_OUT source files you want to modify and set break points with by selecting F9. For example, you may want to set a break point in IPM_IN.cpp on the statement WINAPI DllEntryPoint.


  • Click F5 (Debug Go) to start debugging.


Additional query words:

Keywords : kbEDK kbXchge kbXchge500 kbXchge550 kbMsg kbEDK500 kbEDK550 kbGrpMsg kbDSupport
Version : WINDOWS:5.0,5.5
Platform : WINDOWS
Issue type : kbhowto


Last Reviewed: August 31, 1999
© 2000 Microsoft Corporation. All rights reserved. Terms of Use.