IDebugControl3::ExecuteCommandFile-Methode (dbgeng.h)

Artikel
02/23/2024

Die ExecuteCommandFile-Methode öffnet die angegebene Datei und führt die darin enthaltenen Debuggerbefehle aus.

Syntax

HRESULT ExecuteCommandFile(
  [in] ULONG OutputControl,
  [in] PCSTR CommandFile,
  [in] ULONG Flags
);

Parameter

[in] OutputControl

Gibt an, wohin die Ausgabe des Befehls gesendet werden soll. Mögliche Werte finden Sie unter DEBUG_OUTCTL_XXX. Weitere Informationen zur Ausgabe finden Sie unter Eingabe und Ausgabe.

[in] CommandFile

Gibt den Namen der Datei an, die die auszuführenden Befehle enthält. Diese Datei wird zum Lesen geöffnet, und ihr Inhalt wird so interpretiert, als ob sie in die Debuggerkonsole eingegeben worden wäre.

[in] Flags

Gibt Ausführungsoptionen für den Befehl an. Die Standardoptionen bestehen darin, den Befehl zu protokollieren, aber nicht, um ihn an die Ausgabe zu senden. Ausführliche Informationen zu den Werten, die Flags annehmen können, finden Sie unter Ausführen.

Rückgabewert

Diese Methode gibt möglicherweise auch Fehlerwerte zurück, einschließlich Fehlerwerte, die durch einen Fehler beim Öffnen der angegebenen Datei verursacht wurden. Weitere Informationen finden Sie unter Rückgabewerte.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.

Hinweise

Diese Methode liest die angegebene Datei und führt die Befehle zeilenweise mithilfe von Execute aus. Wenn beim Ausführen einer Zeile eine Ausnahme aufgetreten ist, wird die Ausführung mit der nächsten Zeile fortgesetzt.