Método IDebugControl::ExecuteCommandFile (dbgeng.h)

Artigo
02/26/2024

O método ExecuteCommandFile abre o arquivo especificado e executa os comandos do depurador contidos no .

Sintaxe

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

Parâmetros

[in] OutputControl

Especifica para onde enviar a saída do comando. Para obter valores possíveis, consulte DEBUG_OUTCTL_XXX. Para obter mais informações sobre a saída, consulte Entrada e Saída.

[in] CommandFile

Especifica o nome do arquivo que contém os comandos a serem executados. Esse arquivo é aberto para leitura e seu conteúdo é interpretado como se tivesse sido digitado no console do depurador.

[in] Flags

Especifica as opções de execução para o comando . As opções padrão são registrar o comando em log, mas não enviá-lo para a saída. Para obter detalhes sobre os valores que os Sinalizadores podem levar, consulte Executar.

Retornar valor

Esse método também pode retornar valores de erro, incluindo valores de erro causados por uma falha ao abrir o arquivo especificado. Para obter mais informações, consulte Valores retornados.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.

Comentários

Esse método lê o arquivo especificado e executa os comandos uma linha de cada vez usando Executar. Se ocorrer uma exceção durante a execução de uma linha, a execução continuará com a próxima linha.