Метод IDebugControl4::ExecuteWide (dbgeng.h)

Статья
02/23/2024

Метод ExecuteWide выполняет указанные команды отладчика.

Синтаксис

HRESULT ExecuteWide(
  [in] ULONG  OutputControl,
  [in] PCWSTR Command,
  [in] ULONG  Flags
);

Параметры

[in] OutputControl

Указывает элемент управления выходными данными, используемый при выполнении команды. Возможные значения см. в разделе DEBUG_OUTCTL_XXX. Дополнительные сведения о выходных данных см. в разделе Входные и выходные данные.

[in] Command

Указывает командную строку для выполнения. Команда интерпретируется так же, как в командном окне отладчика. Эта командная строка может содержать несколько команд для выполнения подсистемой. Справочник по командам см. в разделе Команды отладчика .

[in] Flags

Задает битовое поле параметров выполнения для команды. По умолчанию команда записывается в журнал, но не отправляется в выходные данные. В следующей таблице перечислены биты, которые можно задать.

Значение	Описание
DEBUG_EXECUTE_ECHO	Командная строка отправляется в выходные данные.
DEBUG_EXECUTE_NOT_LOGGED	Командная строка не записывается в журнал. Это переопределяется DEBUG_EXECUTE_ECHO.
DEBUG_EXECUTE_NO_REPEAT	Если Command является пустой строкой, не повторяйте последнюю команду и не сохраняйте текущую командную строку для последующего выполнения.

Возвращаемое значение

Этот метод также может возвращать значения ошибок. Дополнительные сведения см. в разделе Возвращаемые значения .

Код возврата	Описание
S_OK	Метод выполнен успешно.

Этот метод выполняет заданную командную строку. Если строка содержит несколько команд, эти методы не будут возвращать их, пока не будут выполнены все команды. Это может включать ожидание выполнения целевого объекта, поэтому выполнение этих методов может занять произвольное время.

Требования

Требование	Значение
Целевая платформа	Персональный компьютер
Верхняя часть	dbgeng.h (включая Dbgeng.h)

См. также раздел

ExecuteCommandFile

IDebugControl4

Поделиться через