Microsoft Identity Integration
Server 2003 Developer Reference
Debugger to the Process
This topic shows how to attach and detach the Visual Studio
debugger to the Microsoft Identity Integration Server 2003 service
process in order to debug your extension.
To attach the
Visual Studio .NET debugger to the Microsoft Identity
Integration Server 2003 service process, perform the following
Ensure the current version of the extension class library is
copied to the Extensions folder under the Microsoft Identity
Integration Server 2003 installation folder.
Open the extension project in Visual Studio .NET.
Insert any required breakpoints.
Select Debug, and then Processes from the Visual
Studio .NET menu. The Processes window, which looks
similar to the following figure, is displayed. The processes,
displayed in the Available Processes list, may vary.
In the Processes window, make the following settings:
Set Transport: to Default.
Set Name: to the Microsoft Identity Integration
Server 2003 server computer name.
Clear the Show system processes check box.
Select the Show processes in all sessions check
In the Available Processes list, select a process and
press the Attach button. The Attach to Process dialog
box, similar to the following figure, is displayed.
For rules extensions, select miiserver.exe. The
extension must be configured to run in-process.
For connected data source extensions, select
miiserver.exe if running in-process or dllhost.exe if
In the Choose the program types that you want to debug
list, select the Common Language Runtime check box and clear
all other check boxes. This step is important because it affects
what happens when the debugger is stopped or detached. If
Native is selected, the Microsoft Identity Integration
Server 2003 server process will have to be terminated to stop
Press OK in the Attach to Process dialog box. The
Processes window now looks similar to the following figure.
In the Processes window, set When debugging is
stopped to Detach from this process.
Press the Close button in the Processes window.
The debugger is now attached to the miiserver.exe process.
Detaching the Debugger
When debugging is complete, the debugger is detached from the
process by selecting Debug - Stop Debugging in the
Visual Studio .NET menu.