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

Статья
02/06/2025

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

Синтаксис

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

Параметры

[out, optional] Buffer

Получает имя открытого файла журнала. Если буферnull, эти сведения не возвращаются.

[in] BufferSize

Задает размер буфера в символах.

[out, optional] FileSize

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

[out] Append

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

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

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

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

Замечания

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

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