IDebugControl3：：Execute 方法 (dbgeng.h)

项目
02/26/2024

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	如果 Command 是空字符串，请不要重复上一个命令，也不要保存当前命令字符串以供以后重复执行。

返回值

此方法还可以返回错误值。有关更多详细信息，请参阅返回值。

返回代码	说明
S_OK	方法成功。

注解

此方法执行给定的命令字符串。如果字符串具有多个命令，则在执行所有命令之前，此方法不会返回。如果命令序列涉及等待目标执行，则此方法可能需要任意时间才能完成。

注意请务必了解执行步骤命令的含义。步骤命令启动单步执行操作，但不等待单步执行完成。例如，假设调用 IDebugControl：：Execute 并传递包含单个命令的命令字符串。pct 命令会启动下一个调用或返回指令的步骤，但 pct 在单步执行之前完成执行。因此， IDebugControl：：Execute 在单步执行之前返回。跟踪和 go 命令的行为方式类似。具有此行为的命令示例包括 g、 gh、 ta、 tb、 tct、 pa 和 pc。