Método IDebugControl::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 obtener 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 comandos 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 enviarlos 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 comandos no se registra. Esto se invalida 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 un tiempo arbitrario en completarse.

Nota Es importante comprender lo que significa para que se ejecute un comando de paso. 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 produzca la ejecución. 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.