Debugger Engine Reference

一、客户端函数

1、DebugConnect

DebugConnect和DebugConnectWide函数创建一个新客户对象并返回一个接口指针给它。这个客户端对象可被连接到一个远程主机。

HRESULT
DebugConnect(
IN PCSTR  RemoteOptions,
IN REFIID  InterfaceId,
OUT PVOID *  Interface
);

HRESULT
DebugConnectWide(
IN PCWSTR  RemoteOptions,
IN REFIID  InterfaceId,
OUT PVOID *  Interface
);

#ifdef UNICODE
#define DebugConnectT DebugConnectWide
#else
#define DebugConnectT DebugConnect
#endif

参数

RemoteOptions

指定调试器引擎将如何连接到远程主机。这跟命令行下的remote命令是相同选项。

InterfaceId

指定调试器引擎客户接口的接口标示（IID）。这是将被返回到Interface的接口的类型。

Interface

返回一个接口指针给新客户。接口的类型被InterfaceId指定。

返回值

S_OK

命令执行成功。

要求

头文件：被定义在dbgeng.h。Include dbgeng.h.

2、DebugCreate

DebugCreate函数创建一个新的客户对象并返回一个借口指针给它。

HRESULT
DebugCreate(
IN REFIID  InterfaceId,
OUT PVOID *  Interface
);

参数

InterfaceId

指定被期望调试器引擎客户接口的接口标示（IID）。这是被返回给Interface的接口类型。关于接口标示更多的信息，请看COM Interfaces。

Interface

给新的客户返回一个接口指针。接口的类型由InterfaceId指定。

返回值

S_OK

返回成功。

E_NOINTERFACE

客户对象没有实施被指定的接口。

内容

传递给DebugCreate的参数跟传递给IUnknown::QueryInterface一样，它们被同等对待。

对于IUnknown::QueryInterface，当返回的接口不再使用，它的IUnknown::Release方法就要被调用。

二、客户COM接口

1、IDebugAdvanced::获取客户端线程、源文件、符号表等相关信息

2、IDebugClient::与客户端相关的一些列方法，包括客户端的创建、结束、附加、会话、事件分发、转储文件的读写等等

3、IDebugControl::与客户端控制相关的一系列方法，包括控制客户端执行、计算、断点操作和一系列输入输出控制。

4、IDebugDataSpaces::与数据相关的一系列方法，包括数据的读写、搜索和信息获取。

5、IDebugRegisters::与寄存器相关的一系列方法，包括栈针信息的获取、指令的获取、寄存器值的读写。

6、IDebugSymbols::与符号相关的一系列方法，包括模块、源文件、符号表

7、IDebugSystemObjects::与系统对象相关一系列方法，包括线程、进程、环境相关信息的获取和设置。

三、回调COM接口

1、IDebugEventCallbacks::包含断点、异常、状态改变、模块加载、进程线程创建等事件的回调函数。

2、IDebugInputCallbacks::包含开始和结束输入的回调函数

3、IDebugOutputCallbacks::只包含一个输出回调函数

四、其他COM接口

1、IDebugBreakpoint::与断点相关的更为详细的方法，包含断点的地址、命令、id、参数的获取和设置。

2、IDebugSymbolGroup::全局符号表的相关操作。

五、结构体和常量