Метод IDebugControl4::OpenLogFile2 (dbgeng.h)

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

Синтаксис

HRESULT OpenLogFile2(
  [in] PCSTR File,
  [in] ULONG Flags
);

Параметры

[in] File

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

[in] Flags

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

Flag Эффект при установке
DEBUG_LOG_APPEND Выходные данные будут добавляться в файл журнала, а не удалять содержимое файла журнала.
DEBUG_LOG_UNICODE Файл журнала будет иметь формат Юникод, а не ASCII.
 

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

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

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

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

Комментарии

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

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

Требования

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

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

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

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

CloseLogFile

GetLogFile2

GetLogMask

IDebugControl4

OpenLogFile

SetLogMask