IDebugControl::Execute 方法 (dbgeng.h)
Execute 方法执行指定的调试器命令。
语法
HRESULT Execute(
[in] ULONG OutputControl,
[in] PCSTR Command,
[in] ULONG Flags
);
参数
[in] OutputControl
指定在执行命令时要使用的输出控件。 有关可能的值,请参阅 DEBUG_OUTCTL_XXX。 有关输出的详细信息,请参阅 输入和输出。
[in] Command
指定要执行的命令字符串。 该命令被解释为类似于在调试器命令窗口中键入的命令窗口。 此命令字符串可以包含多个命令供引擎执行。 有关命令参考,请参阅 调试器命令。
[in] Flags
指定命令的执行选项的位字段。 默认选项是记录命令,但不将其发送到输出。 下表列出了可以设置的位。
价值 | 描述 |
---|---|
DEBUG_EXECUTE_ECHO | 命令字符串将发送到输出。 |
DEBUG_EXECUTE_NOT_LOGGED | 不会记录命令字符串。 这是由DEBUG_EXECUTE_ECHO重写的。 |
DEBUG_EXECUTE_NO_REPEAT | 如果 命令 为空字符串,请不要重复上一个命令,也不会保存当前命令字符串以供稍后重复执行。 |
返回值
此方法还可以返回错误值。 有关详细信息,请参阅 返回值。
返回代码 | 描述 |
---|---|
|
该方法成功。 |
言论
此方法执行给定的命令字符串。 如果字符串具有多个命令,则在执行所有命令之前,此方法不会返回。 如果命令序列涉及等待目标执行,此方法可能需要任意时间才能完成。
注意 请务必了解执行步骤命令的含义。 步骤命令启动单步执行作,但不会等待单步执行完成。 例如,假设调用 IDebugControl::Execute 并传递包含单个命令的命令字符串 百分比。百分比 命令启动下一个调用或返回指令的步骤,但 百分比 在执行单步之前完成其执行。 因此,在单步执行之前,IDebugControl::Execute 返回。 跟踪和 go 命令的行为方式类似。 具有此行为的命令示例包括 g、gh、ta、tb、tct、pa和 pc。
要求
要求 | 价值 |
---|---|
目标平台 | 桌面 |
标头 | dbgeng.h (包括 Dbgeng.h) |