Edit

ICLRDebugManager Interface

  • Article

Provides methods that allow a host to associate a set of tasks with an identifier and a friendly name.

Methods

Method Description
BeginConnection Method Establishes a new connection between the host and the debugger to associate tasks with an identifier and a friendly name.
EndConnection Method Removes the association between a list of tasks and an identifier and a friendly name.
GetDacl Method This method is not implemented.
IsDebuggerAttached Method Gets a value that indicates whether a debugger is attached to the process.
SetConnectionTasks Method Associates a list of ICLRTask instances with an identifier and a friendly name.
SetDacl Method This method is not implemented.
SetSymbolReadingPolicy Method Sets the policy for reading program database (PDB) files. The policy determines whether information about line numbers and files is included in call stacks.

Remarks

In debugging scenarios, a host might want to group tasks according to its own programming logic. For example, a grouping would allow a developer to see only the tasks required by the developer's APIs, instead of seeing every task running in the process. ICLRDebugManager allows the host to implement this kind of grouping.

Important

Three ICLRDebugManager methods, BeginConnection, SetConnectionTasks and EndConnection, are dependent upon each other. They must be called in the given order to work as expected.

The grouping, and the identifiers and friendly names that the host assigns to the grouping, have no meaning for the common language runtime (CLR). The CLR merely passes the information along to the debugger.

Requirements

Platforms: See System Requirements.

Header: MSCorEE.h

Library: Included as a resource in MSCorEE.dll

.NET Framework Versions: Available since 2.0

See also