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

Artigo
08/07/2023

O método Execute executa os comandos de depurador especificados.

Sintaxe

HRESULT Execute(
  [in] ULONG OutputControl,
  [in] PCSTR Command,
  [in] ULONG Flags
);

Parâmetros

[in] OutputControl

Especifica o controle de saída a ser usado durante a execução 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] Command

Especifica a cadeia de caracteres de comando a ser executada. O comando é interpretado como aqueles digitados em uma janela de comando do depurador. Essa cadeia de caracteres de comando pode conter vários comandos para o mecanismo ser executado. Consulte Comandos do Depurador para obter a referência de comando.

[in] Flags

Especifica um campo de bits de 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. A tabela a seguir lista os bits que podem ser definidos.

Valor	Descrição
DEBUG_EXECUTE_ECHO	A cadeia de caracteres de comando é enviada para a saída.
DEBUG_EXECUTE_NOT_LOGGED	A cadeia de caracteres de comando não está registrada. Isso é substituído por DEBUG_EXECUTE_ECHO.
DEBUG_EXECUTE_NO_REPEAT	Se Command for uma cadeia de caracteres vazia, não repita o último comando e não salve a cadeia de caracteres de comando atual para repetir a execução mais tarde.

Retornar valor

Esse método também pode retornar valores de erro. Consulte Valores retornados para obter mais detalhes.

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

Comentários

Esse método executa a cadeia de caracteres de comando fornecida. Se a cadeia de caracteres tiver vários comandos, esse método não retornará até que todos os comandos tenham sido executados. Se a sequência de comandos envolver a espera da execução do destino, esse método poderá levar um tempo arbitrário para ser concluído.

Nota É importante entender o que significa para um comando de etapa ser executado. Um comando de etapa inicia uma ação de etapa, mas não aguarda a conclusão da etapa. Por exemplo, suponha que você chame IDebugControl::Execute e passe uma cadeia de caracteres de comando que contenha o comando único pct. O comando pct inicia uma etapa para a próxima chamada ou instrução de retorno, mas o pct conclui sua execução antes que a etapa ocorra. Consequentemente, IDebugControl::Execute retorna antes da etapa ocorrer. Os comandos Trace e Go se comportam de maneira semelhante. Exemplos de comandos que têm esse comportamento incluem g, gh, ta, tb, tct, pa e pc.