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

Метод GetLogFile возвращает имя открытого в настоящее время файла журнала.

Синтаксис

HRESULT GetLogFile(
  [out, optional] PSTR   Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG FileSize,
  [out]           PBOOL  Append
);

Параметры

[out, optional] Buffer

Получает имя открытого в настоящее время файла журнала. Если параметр Buffer имеет значение NULL, эта информация не возвращается.

[in] BufferSize

Указывает размер буфера буфера буфера (в символах).

[out, optional] FileSize

Получает размер (в символах) имени файла журнала. Если FileSize имеет значение NULL, эти сведения не возвращаются.

[out] Append

Получает значение TRUE , если сообщения журнала добавляются в файл журнала, или false , если содержимое файла журнала было удалено при открытии файла.

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

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

Код возврата Описание
S_OK
Метод выполнен успешно.
S_FALSE
Метод выполнен успешно. Однако имя файла журнала было слишком длинным, чтобы поместиться в буфер буфера , поэтому имя было усечено.
E_NOINTERFACE
В настоящее время открытый файл журнала отсутствует.

Комментарии

GetLogFile и GetLogFileWide ведут себя так же, как GetLogFile2 и GetLogFile2Wide , при этом Append получает только сведения о флаге DEBUG_LOG_APPEND.

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

Требования

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

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

CloseLogFile

GetLogFile2

GetLogMask

IDebugControl

IDebugControl2

IDebugControl3

OpenLogFile