HOWTO: Debug a Dynamic-Link Library (DLL) in Windows

ID: Q85221


The information in this article applies to:
  • The Visual Workbench Integrated Debugger
    • Microsoft Visual C++ for Windows, 16-bit edition, versions 1.0, 1.5, 1.51, 1.52
    • Microsoft Visual C++, 32-bit Editions, versions 1.0, 2.0, 2.1, 4.0, 5.0


SUMMARY

The process of developing a dynamic-link library (DLL) with Visual C++ usually includes debugging. To do so, you must build a debugging version of the DLL and call it from an application. However, it is not necessary to build the debugging version of the calling application or to build the caller with Visual C++.


MORE INFORMATION

The following five steps demonstrate debugging a DLL. Note that it is not within the scope of this article to provide detailed instructions for building the DLL.

  1. Build the DLL with debugging information.


  2. Specify the fully-qualified path to the calling application. In Visual C++ for Windows and Visual C++ 32-bit Edition version 1.0, choose Debug from the Options menu and enter the information under Calling Program. In Visual C++ 2.x and 5.0, choose Settings from the Project menu; in Visual C++ 4.0, choose Settings from the Build menu. Select the Debug tab, and enter the information under Executable For Debug Session.


  3. Set a breakpoint in the source code of the DLL function to debug. To do this, place the cursor on the line in the source code to contain the breakpoint and press F9.


  4. Choose Restart from the Debug menu. If the calling program does not contain debugging information, a dialog box appears asking you to confirm your choice. Choose OK and the program starts execution.


  5. After you perform the necessary steps to execute the function that contains the breakpoint, execution stops on the specified line of code.


Additional query words: symbolic

Keywords : kbDebug kbide kbVC100 kbVC150 kbVC151 kbVC152 kbVC200 kbVC210 kbVC400 kbVC500
Version : WIN3X:1.0,1.5,1.51,1.52;WINNT:1.0,2.0,2.1,4.0,5.0;
Platform : NT WINDOWS
Issue type : kbhowto


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