Método IDebugControl4::ExecuteWide (dbgeng.h)

Artigo
02/06/2025

O método ExecuteWide executa os comandos do depurador especificados.

Sintaxe

HRESULT ExecuteWide(
  [in] ULONG  OutputControl,
  [in] PCWSTR 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 comandos pode conter vários comandos para o mecanismo a 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 é registrada em log. 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.

Valor de retorno

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

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

Observações

Esse método executa a cadeia de caracteres de comando fornecida. Se a cadeia de caracteres tiver vários comandos, esses métodos não retornarão até que todos os comandos tenham sido executados. Isso pode envolver a espera para que o destino seja executado, de modo que esses métodos possam levar um período arbitrário de tempo para serem concluídos.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	dbgeng.h (inclua Dbgeng.h)

Consulte também

ExecuteCommandFile

IDebugControl4

Partilhar via