Функция ClfsQueryLogFileInformation (wdm.h)

Статья
02/07/2025

Подпрограмма clfsQueryLogFileInformation возвращает метаданные и сведения о состоянии для указанного потока CLFS или базового физического журнала или обоих.

Синтаксис

CLFSUSER_API NTSTATUS ClfsQueryLogFileInformation(
  [in]  PLOG_FILE_OBJECT           plfoLog,
  [in]  CLFS_LOG_INFORMATION_CLASS eInformationClass,
        PVOID                      pinfoInputBuffer,
        ULONG                      cbinfoInputBuffer,
  [out] PVOID                      pinfoBuffer,
        PULONG                     pcbInfoBuffer
);

Параметры

[in] plfoLog

Указатель на структуру LOG_FILE_OBJECT, представляющую поток CLFS. Вызывающий объект ранее получил этот указатель путем вызова ClfsCreateLogFile.

[in] eInformationClass

Значение перечисления CLFS_LOG_INFORMATION_CLASS, указывающее тип запрашиваемой информации.

pinfoInputBuffer

Необязательный входной буфер, необходимый для некоторых классов информации.

cbinfoInputBuffer

Длина в байтах pinfoInputBuffer.

[out] pinfoBuffer

Указатель на буфер, получающий сведения журнала. Структура этого буфера зависит от значения eInformationClass. В следующей таблице показана связь между классом сведений и типом данных буфера.

Значение eInformationClass	Тип буфера, на который указывает pinfoBuffer
ClfsLogBasicInformation	CLFS_INFORMATION
ClfsLogBasicInformationPhysical	CLFS_INFORMATION
ClfsLogNameInformation	CLFS_LOG_NAME_INFORMATION
ClfsLogPhysicalNameInformation	CLFS_LOG_NAME_INFORMATION
ClfsLogStreamIdentifierInformation	CLFS_STREAM_ID_INFORMATION

pcbInfoBuffer

Длина в байтах буфера входящих сведений.

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

ClfsQueryLogFileInformation возвращает STATUS_SUCCESS в случае успешного выполнения; в противном случае возвращается один из кодов ошибок, определенных в Ntstatus.h.

Замечания

Описание концепций и терминологии CLFS см. в common Log File System.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно в Windows Server 2003 R2, Windows Vista и более поздних версиях Windows.
целевая платформа	Настольный
заголовка	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
библиотеки	Clfs.lib
DLL	Clfs.sys
IRQL	<= APC_LEVEL

См. также

ClfsSetLogFileInformation

Поделиться через