此接口表示在进程中运行的程序。
语法
IDebugProgram2 : IUnknown
实现者须知
调试引擎 (DE) 和自定义端口供应商实现此接口来表示进程中的程序。 会话调试管理器(SDM)还实现此接口,以提供附加信息。
对调用者的说明
IDebugProgramCreateEvent2 事件为新程序返回此接口。 此接口还用作多个接口上许多方法的参数。
Vtable 顺序中的方法
下表显示了 IDebugProgram2 方法。
| 方法 | 说明 |
|---|---|
| EnumThreads | 枚举在此程序中运行的线程。 |
| GetName | 获取程序的名称。 |
| GetProcess | 获取此程序正在运行的进程。 |
| Terminate | 终止此程序。 |
| 附加 | 附加到此程序。 |
| CanDetach | 确定调试引擎 (DE) 是否可以从程序分离。 |
| 分离 | 从此程序分离调试器。 |
| GetProgramId | 获取此程序的全局唯一标识符。 |
| GetDebugProperty | 获取程序属性。 |
| 执行 | 继续从停止状态运行此程序。 清除以前的任何执行状态。 |
| Continue | 继续从停止状态运行此程序。 保留以前的任何执行状态。 |
| 步骤 | 执行步骤。 |
| CauseBreak | 请求此程序下次运行代码时停止执行。 |
| GetEngineInfo | 获取运行此程序的调试引擎(DE)的名称和标识符。 |
| EnumCodeContexts | 枚举源文件中给定位置的代码上下文。 |
| GetMemoryBytes | 获取此程序的内存字节。 |
| GetDisassemblyStream | 获取此程序或此程序的一部分的反汇编流。 |
| EnumModules | 枚举此程序已加载和执行的模块。 |
| GetENCUpdate | 获取此程序的“编辑并继续”更新。 自定义调试引擎不实现此方法(应始终返回 E_NOTIMPL)。 |
| EnumCodePaths | 枚举此程序的代码路径。 |
| WriteDump | 将转储写入文件。 |
要求
标头:msdbg.h
命名空间:Microsoft.VisualStudio.Debugger.Interop
程序集:Microsoft.VisualStudio.Debugger.Interop.dll
备注
程序是在特定运行时体系结构中运行的线程容器,而进程由一个或多个程序组成。