Compartilhar via

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

  • Artigo

O método ExecuteWide executa os comandos de 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 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, esses métodos não retornarão até que todos os comandos tenham sido executados. Isso pode envolver a espera da execução do destino, para que esses métodos possam levar um tempo arbitrário para serem concluídos.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho dbgeng.h (inclua Dbgeng.h)

Confira também

ExecuteCommandFile

IDebugControl4