Метод 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 , если содержимое файла журнала было удалено при открытии файла.
Возвращаемое значение
Этот метод также может возвращать значения ошибок. Дополнительные сведения см. в разделе Возвращаемые значения .
Код возврата | Описание |
---|---|
|
Метод выполнен успешно. |
|
Метод выполнен успешно. Однако имя файла журнала было слишком длинным, чтобы поместиться в буфер буфера , поэтому имя было усечено. |
|
В настоящее время открытый файл журнала отсутствует. |
Комментарии
GetLogFile и GetLogFileWide ведут себя так же, как GetLogFile2 и GetLogFile2Wide , при этом Append получает только сведения о флаге DEBUG_LOG_APPEND.
Дополнительные сведения о файлах журналов см. в разделе Использование входных и выходных данных.
Требования
Требование | Значение |
---|---|
Целевая платформа | Персональный компьютер |
Верхняя часть | dbgeng.h (включая Dbgeng.h) |