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


Метод IDebugControl2::ExecuteCommandFile (dbgeng.h)

Метод ExecuteCommandFile открывает указанный файл и выполняет команды отладчика, содержащиеся в нем.

Синтаксис

HRESULT ExecuteCommandFile(
  [in] ULONG OutputControl,
  [in] PCSTR CommandFile,
  [in] ULONG Flags
);

Параметры

[in] OutputControl

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

[in] CommandFile

Указывает имя файла, содержащего команды для выполнения. Этот файл открывается для чтения, и его содержимое интерпретируется так, как если бы они были введены в консоль отладчика.

[in] Flags

Задает параметры выполнения для команды. Параметры по умолчанию — регистрировать команду, но не отправлять ее в выходные данные. Дополнительные сведения о значениях, которые могут принимать флаги , см. в разделе Выполнение.

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

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

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

Комментарии

Этот метод считывает указанный файл и выполняет команды по одной строке за раз с помощью команды Execute. Если при выполнении строки возникло исключение, выполнение продолжится со следующей строкой.

Требования

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

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

Execute

IDebugControl

IDebugControl2

IDebugControl3