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

Статья
03/05/2024

Подпрограмма 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.

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows Server 2003 R2, Windows Vista и более поздних версиях Windows.
Целевая платформа	Персональный компьютер
Верхняя часть	wdm.h (включая Wdm.h)
Библиотека	Clfs.lib
DLL	Clfs.sys
IRQL	<= APC_LEVEL