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

Статья
02/23/2024

Метод OpenLogFile открывает файл журнала, который будет получать выходные данные от клиентских объектов.

Синтаксис

HRESULT OpenLogFile(
  [in] PCSTR File,
  [in] BOOL  Append
);

Параметры

[in] File

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

[in] Append

Указывает, следует ли добавлять сообщения журнала в существующий файл журнала. Если задано значение TRUE, сообщения журнала будут добавлены в файл ; Значение false, содержимое любого существующего файла, соответствующего Файлу , удаляется.

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

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

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

OpenLogFile и OpenLogFileWide ведут себя так же, как OpenLogFile2 и OpenLogFile2Wide с флагами , для которых задано значение DEBUG_LOG_APPEND, если параметр Append имеет значение TRUE , и DEBUG_LOG_DEFAULT в противном случае.

Одновременно можно открыть только один файл журнала. Если файл журнала уже открыт, он будет закрыт.

Дополнительные сведения о файлах журналов см. в разделе Использование входных и выходных данных.