ISAPI: Debugging

Home |  Overview |  How Do I

Preparing to debug your program requires careful attention to the setup steps. A detailed list of steps to set up your server for debugging is in technical note TN063: Debugging Internet Extension DLLs.

Getting Ready to Debug Your Application

The general steps to prepare for debugging include:

• Creating a project file that sets up a workspace for the server application, with options to run the service interactively, and specifying a list of the DLLs you will be debugging.
  
  
• Setting up permissions in the Windows NT User Manager. You must log off and log back on for the permissions to take effect.
  
  
• Stopping and restarting the service.

If you follow the steps in Technical Note 63 carefully, you will be able to set breakpoints for any of your filters and extensions from one project file based on the Internet server program you are running. If your debugging session doesn’t stop on the breakpoints you’ve set, go through the steps again. In particular, be sure you have installed the right files on the right computers and have set the appropriate permissions.

After you have successfully completed the setup described in Technical Note 63, you can debug locally on your server. It is often useful to be able to debug remotely, from another machine, because you may not always have access to the server, or it may not have a development environment installed. You can follow the steps described in Debugging Remote Applications to set up a Windows NT workstation computer to remotely debug an ISAPI DLL without logging on to the server directly.

Additional Steps For Remote Debugging

Additional steps to prepare for remote debugging include:

• Set up both computers: the server (target) and the computer on which you will be running the debugging session and setting breakpoints (host).
  
  
• Install remote debug monitor files, run MSVCMON.EXE, and follow the additional steps as described in the article Debugging Remote Applications. Install project files on both computers.
  
  
• In the development environment, specify additional debug settings, including the remote executable file name. From the Build menu, specify the server computer name as the Debugger Remote Connection.

See Also   Internet: Where Is...