ClfsSetLogFileInformation-Funktion (wdm.h)

Artikel
02/27/2024

Die ClfsSetLogFileInformation-Routine legt Metadaten und Zustandsinformationen für einen angegebenen Stream und dessen zugrunde liegendes physisches 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-Stream darstellt. Der Aufrufer hat diesen Zeiger zuvor durch Aufrufen von ClfsCreateLogFile abgerufen.

[in] eInformationClass

Ein CLFS_LOG_INFORMATION_CLASS Wert, der die Klasse der festzulegenden Informationen angibt.

[in] pinfoBuffer

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

Wert von eInformationClass	Typ des Puffers, auf den pinfoBuffer verweist
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 pinfoBuffer verweist.

Rückgabewert

ClfsSetLogFileInformation gibt bei Erfolg STATUS_SUCCESS zurück. Andernfalls wird einer der in "Ntstatus.h" definierten Fehlercodes zurückgegeben.

Hinweise

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows Server 2003 R2, Windows Vista und höheren Versionen von Windows.
Zielplattform	Desktop
Kopfzeile	wdm.h (wdm.h einschließen)
Bibliothek	Clfs.lib
DLL	Clfs.sys
IRQL	<= APC_LEVEL