Metodo IDebugControl2::ExecuteCommandFile (dbgeng.h)

Articolo
02/23/2024

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 fosse stato digitato nella console del debugger.

[in] Flags

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

Valore restituito

Questo metodo potrebbe anche restituire valori di errore, inclusi i valori di errore causati da un errore per aprire il file specificato. Per altre informazioni, vedere Valori restituiti.

Codice restituito	Descrizione
S_OK	Il metodo è stato eseguito correttamente.

Commenti

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.