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

Artigo
08/07/2023

O método Execute executa os comandos do 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 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 executar. 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, 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 é 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 execução repetida 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 pela 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 em etapas, 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 único comando pct. O comando pct inicia uma etapa para a próxima chamada ou instrução de retorno, mas pct conclui sua execução antes que a etapa ocorra. Consequentemente, IDebugControl::Execute retorna antes que a etapa ocorra. 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.