ICorDebug 接口

提供允许开发人员在公共语言运行时 (CLR) 环境中调试应用程序的方法。

备注

非 x86 平台(如 IA64 和 AMD64)不支持混合模式(托管代码和本机代码)调试。

方法

方法 说明
CanLaunchOrAttach 方法 确定在当前计算机和运行时配置的上下文中是启动新进程还是附加到给定进程。
CreateProcess 方法 在调试器的控制下启动某个进程及其主线程。
DebugActiveProcess 方法 将调试器附加到现有进程。
EnumerateProcesses 方法 获取正在调试的进程的枚举器。
GetProcess 方法 返回具有给定进程 ID 的“ICorDebugProcess”对象。
Initialize 方法 初始化 ICorDebug 对象。
SetManagedHandler 方法 指定托管事件的事件处理程序对象。
SetUnmanagedHandler 方法 指定未托管事件的事件处理程序对象。
Terminate 方法 终止 ICorDebug 对象。

备注

ICorDebug 表示调试器进程的事件处理循环。 在释放此接口之前,调试器必须等待正在调试的所有进程中的 ICorDebugManagedCallback::ExitProcess 回调。

ICorDebug 对象是控制所有进一步托管调试的初始对象。 在 .NET Framework 版本 1.0 和 1.1 中,此对象是从 COM 创建的 CoClass 对象。 在 .NET Framework 版本 2.0 中,此对象不再是 CoClass 对象。 它必须由 CreateDebuggingInterfaceFromVersion 函数创建,该函数更具版本感知性。 此新的创建函数使客户端能够获取 ICorDebug 的特定实现,该实现还模拟调试 API 的特定版本。

备注

此接口不支持跨计算机或跨进程远程调用。

要求

平台:请参阅系统要求

标头:CorDebug.idl、CorDebug.h

库:CorGuids.lib

.NET Framework 版本:自 1.0 起可用

另请参阅