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

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

Синтаксис

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

Параметры

[in] File

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

[in] Append

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

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

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

Замечания

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

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

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

Требования

См. также

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

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

CloseLogFile

GetLogFile

GetLogMask

IDebugControl

IDebugControl2

IDebugControl3

OpenLogFile2

SetLogMask