HOWTO: Debug OLE Server Applications Using MSVC

• Microsoft OLE libraries
  • Microsoft Windows NT 3.51
  • Microsoft Windows versions 95, 4.0

SUMMARY

An OLE client application involves interaction with other OLE server applications. This interaction could be with in-process or out-of-process servers. The client application may or may not have debugging information. These combinations make the debugging process of an OLE application complicated. This article presents some techniques that can be used for debugging OLE-enabled applications.

MORE INFORMATION

Debugging an In-Process OLE Server Application

Debugging an Out-of-Process OLE Server Application

• Setup a hardcoded breakpoint in the server, and when the breakpoint hits in the server code, the Microsoft Visual C++ (MSVC) debugger is launched. Then step through server code and add breakpoints at locations of interest in server code.
  
  Add the following line of code in the source code, where a hardcoded breakpoint is needed.
  
  DebugBreak();



• Setup a breakpoint in the container/client application, then step into the code where the server code is called. The action of stepping into the code causes a new version of the MVSC debugger to be launched with the Server debug information. Then you can step through the server code and add breakpoints at locations of interest in the server code. To configure this, check in the MSVC option, the Tool Option, the debug tab, the Just-in-time debugging, and the OLE RPC debugging checkboxes that need to be checked. This technique requires source code and a debug version of the client application as well. For more information, please see the following article in the Microsoft Knowledge Base:
  
  Q154116 Tutorial: Debugging OLE Applications
  
  

• Launch the server application from the client and then find the process id of the server application using PView. Launch the MSVC -p <process ID>. This launches the MSVC option that attaches itself to the running server application. However, this technique is not useful in debugging the startup code of the server application. For more information, please see the following article in the Microsoft Knowledge Base:
  
  Q120707 How to Debug an Active Process in Visual C++ 2.0
  
  



• If the server application has registered the ClassFactory object with the system as single use (CoRegisterClassObject with CLS_SINGLEUSE flag), you can run the server application from the MSVC option as stand alone. To simulate the server being launched from the container/client application, you need to specify the /Embedding /Automation program arguments as applicable in the MSVC debug options and run the server application as stand alone. The /Embedding and /Automation switches do the appropriate server initialization, and register the class factory as if launched from the container/client application. Because the server's class factory is single use and not already connected, when the container/client application tries to hook up to the server, the container connects to the running server application in the debugger, and debugging is easier. For more information, please see the following article in the Microsoft Knowledge Base:
  
  Q117558 HOWTO: Debug OLE Applications
  
  



• If the server application registers the ClassFactory object with the system as multiple use (CoRegisterClassObject with CLS_MULTIPLEUSE flag), run the server application from the MSVC option as stand alone. Since such servers register the ClassFactory on startup, you do not need to specify /Embedding /Automation program arguments in the MSVC debug options. When the container/client application tries to connect to the server, it connects to the instance of the server application in the debugger because the server's class factory is registered multiple use, and debugging is easier.

Additional query words: 3.50

Keywords          : kbtshoot LeTwoOth 
Version           : WINNT:3.51
Platform          : NT Win95 WINDOWS 
Issue type        : kbhowto 

Last Reviewed: March 9, 1999