Freigeben über


ClfsSetLogFileInformation-Funktion (wdm.h)

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

Weitere Informationen

CLFS_INFORMATION

CLFS_LOG_INFORMATION_CLASS

CLFS_STREAM_ID_INFORMATION

ClfsCreateLogFile

ClfsQueryLogFileInformation

LOG_FILE_OBJECT