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

Метод 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 в противном случае.

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

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

Требования

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

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

.logappend (добавление файла журнала)

.logopen (открыть файл журнала)

CloseLogFile

GetLogFile

GetLogMask

IDebugControl

IDebugControl2

IDebugControl3

OpenLogFile2

SetLogMask