Функция 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 |