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

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

  • Статья

Подпрограмма 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 (включая Wdm.h, Ntddk.h, Ntifs.h)
Библиотека Clfs.lib
DLL Clfs.sys
IRQL <= APC_LEVEL

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

ClfsSetLogFileInformation