Функция GetLogFileInformation (clfsw32.h)

  • Статья

Возвращает буфер, содержащий метаданные об указанном журнале и его текущем состоянии, которое определяется структурой CLFS_INFORMATION .

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

Синтаксис

CLFSUSER_API BOOL GetLogFileInformation(
  [in]      HANDLE            hLog,
  [in, out] PCLFS_INFORMATION pinfoBuffer,
  [in, out] PULONG            cbBuffer
);

Параметры

[in] hLog

Дескриптор открытого журнала, полученный в результате успешного вызова CreateLogFile.

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

[in, out] pinfoBuffer

Указатель на структуру, выделенную пользователем CLFS_INFORMATION , которая получает метаданные журнала.

[in, out] cbBuffer

Указатель на переменную, которая во входных данных указывает размер буфера метаданных в байтах, на который указывает pinfoBuffer.

В выходных данных он указывает количество байтов, которые фактически копируются в pinfoBuffer.

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

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

В следующем списке указаны возможные коды ошибок:

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2003 R2 [только классические приложения]
Целевая платформа Windows
Header clfsw32.h
Библиотека Clfsw32.lib
DLL Clfsw32.dll

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

CLFS_INFORMATION

Общие функции файловой системы журнала

CreateLogFile

Получение следующего номера LSN