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

Статья
02/06/2025

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

Синтаксис

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

Параметры

[in] OutputControl

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

[in] CommandFile

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

[in] Flags

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

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

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

Возвращаемый код	Описание
S_OK	Метод был успешным.

Замечания

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