Metodo IDebugControl3::ExecuteCommandFile (dbgeng.h)

Articolo
02/06/2025

Il metodo ExecuteCommandFile apre il file specificato ed esegue i comandi del debugger contenuti all'interno.

Sintassi

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

Parametri

[in] OutputControl

Specifica dove inviare l'output del comando. Per i valori possibili, vedere DEBUG_OUTCTL_XXX. Per altre informazioni sull'output, vedere input e output.

[in] CommandFile

Specifica il nome del file che contiene i comandi da eseguire. Questo file viene aperto per la lettura e il relativo contenuto viene interpretato come se fossero stati digitati nella console del debugger.

[in] Flags

Specifica le opzioni di esecuzione per il comando. Le opzioni predefinite consentono di registrare il comando ma non di inviarlo all'output. Per informazioni dettagliate sui valori che possono essere flag, vedere Esegui.

Valore restituito

Questo metodo potrebbe anche restituire valori di errore, inclusi i valori di errore causati da un errore durante l'apertura del file specificato. Per altre informazioni, vedere valori restituiti.

Codice restituito	Descrizione
S_OK	Il metodo ha avuto esito positivo.

Osservazioni

Questo metodo legge il file specificato ed esegue i comandi una riga alla volta usando Execute. Se si è verificata un'eccezione durante l'esecuzione di una riga, l'esecuzione continuerà con la riga successiva.