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

Artículo
02/23/2024

El método Execute ejecuta los comandos del depurador especificados.

Sintaxis

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

Parámetros

[in] OutputControl

Especifica el control de salida que se va a usar al ejecutar el comando. Para conocer los valores posibles, consulte DEBUG_OUTCTL_XXX. Para obtener más información sobre la salida, consulte Entrada y salida.

[in] Command

Especifica la cadena de comando que se va a ejecutar. El comando se interpreta como los que se escriben en una ventana de comandos del depurador. Esta cadena de comando puede contener varios comandos para que se ejecute el motor. Consulte Comandos del depurador para obtener la referencia de comandos.

[in] Flags

Especifica un campo de bits de opciones de ejecución para el comando. Las opciones predeterminadas son registrar el comando, pero no enviarla a la salida. En la tabla siguiente se enumeran los bits que se pueden establecer.

Valor	Descripción
DEBUG_EXECUTE_ECHO	La cadena de comando se envía a la salida.
DEBUG_EXECUTE_NOT_LOGGED	La cadena de comando no se registra. Esto se reemplaza por DEBUG_EXECUTE_ECHO.
DEBUG_EXECUTE_NO_REPEAT	Si Command es una cadena vacía, no repita el último comando y no guarde la cadena de comando actual para repetir la ejecución más adelante.

Valor devuelto

Este método también puede devolver valores de error. Consulte Valores devueltos para obtener más detalles.

Código devuelto	Descripción
S_OK	Método realizado correctamente.

Comentarios

Este método ejecuta la cadena de comandos especificada. Si la cadena tiene varios comandos, este método no devolverá hasta que se hayan ejecutado todos los comandos. Si la secuencia de comandos implica esperar a que se ejecute el destino, este método puede tardar una cantidad arbitraria de tiempo en completarse.

Nota Es importante comprender lo que significa que un comando de paso se ejecute. Un comando de paso inicia una acción paso a paso, pero no espera a que se complete la ejecución paso a paso. Por ejemplo, supongamos que llama a IDebugControl::Execute y pasa una cadena de comando que contiene el pct de comandos único. El comando pct inicia un paso a la siguiente llamada o instrucción de devolución, pero pct completa su ejecución antes de que se realice la ejecución paso a paso. Por lo tanto, IDebugControl::Execute devuelve antes de que se realice la ejecución paso a paso. Los comandos trace y go se comportan de forma similar. Algunos ejemplos de comandos que tienen este comportamiento son g, gh, ta, tb, tct, pa y pc.