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

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

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 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 no log, mas não enviá-lo para a saída. Para obter detalhes sobre os valores que o Flags pode levar, consulte Executar.

Valor retornado

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 por vez usando Execute. Se ocorrer uma exceção durante a execução de uma linha, a execução continuará com a próxima linha.

Requisitos

   
Plataforma de Destino Desktop
Cabeçalho dbgeng.h (inclua Dbgeng.h)

Confira também

Executar

Idebugcontrol

IDebugControl2

IDebugControl3