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

2025-02-07

ClfsSetLogFileInformation задает метаданные и сведения о состоянии для указанного потока и его основного физического журнала.

Синтаксис

CLFSUSER_API NTSTATUS ClfsSetLogFileInformation(
  [in] PLOG_FILE_OBJECT           plfoLog,
  [in] CLFS_LOG_INFORMATION_CLASS eInformationClass,
  [in] PVOID                      pinfoBuffer,
  [in] ULONG                      cbBuffer
);

Параметры

[in] plfoLog

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

[in] eInformationClass

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

[in] 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

[in] cbBuffer

Размер буфера в байтах, на который указывает pinfoBuffer.

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

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

Замечания

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

Требования

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