ClfsSetLogFileInformation-Funktion (wdm.h)

Artikel
02/07/2025

Die ClfsSetLogFileInformation Routine legt Metadaten- und Zustandsinformationen für einen angegebenen Datenstrom und das zugrunde liegende physische Protokoll fest.

Syntax

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

Parameter

[in] plfoLog

Ein Zeiger auf eine LOG_FILE_OBJECT Struktur, die einen CLFS-Datenstrom darstellt. Der Aufrufer hat diesen Zeiger zuvor durch Aufrufen ClfsCreateLogFileabgerufen.

[in] eInformationClass

Ein CLFS_LOG_INFORMATION_CLASS Wert, der die festgelegte Informationsklasse angibt.

[in] pinfoBuffer

Ein Zeiger auf einen Puffer, der die Protokollinformationen bereitstellt. Die Struktur dieses Puffers variiert je nach der Von eInformationClassangegebenen Informationsklasse. Die folgende Tabelle zeigt die Beziehung zwischen der Informationsklasse und dem Puffertyp.

Wert von eInformationClass	Typ des Puffers, der von pinfoBuffer-
ClfsLogBasicInformation	CLFS_INFORMATION
ClfsLogBasicInformationPhysical	CLFS_INFORMATION
ClfsLogNameInformation	CLFS_LOG_NAME_INFORMATION
ClfsLogPhysicalNameInformation	CLFS_LOG_NAME_INFORMATION
ClfsLogStreamIdentifierInformation	CLFS_STREAM_ID_INFORMATION

[in] cbBuffer

Die Größe des Puffers in Bytes, auf den pinfoBufferverweist.

Rückgabewert

ClfsSetLogFileInformation gibt STATUS_SUCCESS zurück, wenn sie erfolgreich ist; andernfalls wird eine der fehlercodes zurückgegeben, die in Ntstatus.h definiert sind.

Bemerkungen

Eine Erläuterung der CLFS-Konzepte und -Terminologie finden Sie unter Common Log File System.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar in Windows Server 2003 R2, Windows Vista und höheren Versionen von Windows.
Zielplattform-	Desktop
Header-	wdm.h (include Wdm.h)
Library	Clfs.lib
DLL-	Clfs.sys
IRQL-	<= APC_LEVEL