IDebugControl3::Execute-Methode (dbgeng.h)

Artikel
02/06/2025

Die Execute-Methode führt die angegebenen Debuggerbefehle aus.

Syntax

HRESULT Execute(
  [in] ULONG OutputControl,
  [in] PCSTR Command,
  [in] ULONG Flags
);

Parameter

[in] OutputControl

Gibt das Ausgabesteuerelement an, das beim Ausführen des Befehls verwendet werden soll. Mögliche Werte finden Sie unter DEBUG_OUTCTL_XXX. Weitere Informationen zur Ausgabe finden Sie unter Eingabe- und Ausgabe-.

[in] Command

Gibt die auszuführende Befehlszeichenfolge an. Der Befehl wird wie in ein Debugger-Befehlsfenster eingegebene interpretiert. Diese Befehlszeichenfolge kann mehrere Befehle enthalten, damit das Modul ausgeführt werden kann. Informationen zur Befehlsreferenz finden Sie unter Debuggerbefehle.

[in] Flags

Gibt ein Bitfeld mit Ausführungsoptionen für den Befehl an. Die Standardoptionen sind das Protokollieren des Befehls, aber nicht an die Ausgabe. In der folgenden Tabelle sind die Bits aufgeführt, die festgelegt werden können.

Wert	Beschreibung
DEBUG_EXECUTE_ECHO	Die Befehlszeichenfolge wird an die Ausgabe gesendet.
DEBUG_EXECUTE_NOT_LOGGED	Die Befehlszeichenfolge wird nicht protokolliert. Dies wird durch DEBUG_EXECUTE_ECHO außer Kraft gesetzt.
DEBUG_EXECUTE_NO_REPEAT	Wenn Command eine leere Zeichenfolge ist, wiederholen Sie nicht den letzten Befehl, und speichern Sie die aktuelle Befehlszeichenfolge nicht für die spätere Wiederholungsausführung.

Rückgabewert

Diese Methode kann auch Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte.

Rückgabecode	Beschreibung
S_OK	Die Methode war erfolgreich.

Bemerkungen

Diese Methode führt die angegebene Befehlszeichenfolge aus. Wenn die Zeichenfolge über mehrere Befehle verfügt, wird diese Methode erst zurückgegeben, wenn alle Befehle ausgeführt wurden. Wenn die Abfolge von Befehlen das Warten auf die Ausführung des Ziels umfasst, kann diese Methode eine beliebige Zeit in Anspruch nehmen, bis das Ziel ausgeführt wird.

Hinweis Es ist wichtig zu verstehen, was es bedeutet, dass ein Schrittbefehl ausgeführt werden kann. Ein Schrittbefehl initiiert eine Schrittaktion, wartet jedoch nicht auf den Abschluss des Schritts. Angenommen, Sie rufen IDebugControl::Execute auf und übergeben eine Befehlszeichenfolge, die den einzelnen Befehl pctenthält. Der pct- Befehl initiiert einen Schritt zum nächsten Aufruf oder zur Rückgabe einer Anweisung, aber pct die Ausführung vor dem Ausführen des Schritts abgeschlossen. Folglich gibt IDebugControl::Execute zurück, bevor das Schrittschritt ausgeführt wird. Ablaufverfolgungs- und Go-Befehle verhalten sich ähnlich. Beispiele für Befehle mit diesem Verhalten sind g, gh, ta, tb, tct, paund PC.