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

Статья
02/23/2024

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

Синтаксис

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

Параметры

[in] OutputControl

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

[in] CommandFile

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

[in] Flags

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

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

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

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

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