ClfsRemoveLogContainer-Funktion (wdm.h)

Artikel
02/27/2024

Die ClfsRemoveLogContainer-Routine entfernt einen Container aus einem CLFS-Protokoll.

Syntax

CLFSUSER_API NTSTATUS ClfsRemoveLogContainer(
  [in] PLOG_FILE_OBJECT plfoLog,
  [in] PUNICODE_STRING  puszContainerPath,
  [in] BOOLEAN          fForce
);

Parameter

[in] plfoLog

Ein Zeiger auf eine LOG_FILE_OBJECT-Struktur , die ein CLFS-Protokoll darstellt, aus dem der Container entfernt wird. Der Aufrufer hat diesen Zeiger zuvor durch Aufrufen von ClfsCreateLogFile abgerufen.

[in] puszContainerPath

Ein Zeiger auf eine UNICODE_STRING Struktur, die den Pfadnamen für den zu entfernenden Container angibt. Der Pfadname wurde in einem vorherigen Aufruf von ClfsAddLogContainer oder ClfsAddLogContainerSet erstellt. Der Pfad kann absolut oder relativ zum Speicherort der Basisprotokolldatei für das CLFS-Protokoll sein, das durch plfoLog dargestellt wird. Pfade, die relativ zur Basisprotokolldatei sind, müssen mit CLFS_CONTAINER_RELATIVE_PREFIX beginnen, wobei es sich um das Zeichenfolgenliteral (L"%BLF%\") handelt. Die Verzeichnisse "." und ".." sind in einem relativen Pfad nicht zulässig.

[in] fForce

Ein boolescher Wert, der angibt, ob die Containerentfernung erzwungen (TRUE) oder lazy (FALSE) ist.

Rückgabewert

ClfsRemoveLogContainer gibt STATUS_SUCCESS zurück, wenn dies erfolgreich ist. Andernfalls wird einer der in "Ntstatus.h" definierten Fehlercodes zurückgegeben.

Hinweise

Die erzwungene Containerentfernung (fForce = TRUE) ist nur erfolgreich, wenn der zu entfernende Container nicht Teil des aktiven Protokolls ist.

Eine Erläuterung der CLFS-Konzepte und -Terminologie finden Sie unter Allgemeines Protokolldateisystem.

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 (einschließen von Wdm.h)
Bibliothek	Clfs.lib
DLL	Clfs.sys
IRQL	<= APC_LEVEL