ClfsRemoveLogContainerSet-Funktion (wdm.h)

Die ClfsRemoveLogContainerSet-Routine entfernt atomar eine Gruppe von Containern aus einem CLFS-Protokoll.

Syntax

CLFSUSER_API NTSTATUS ClfsRemoveLogContainerSet(
  [in] PLOG_FILE_OBJECT plfoLog,
  [in] USHORT           cContainers,
  [in] PUNICODE_STRING  rgwszContainerPath,
  [in] BOOLEAN          fForce
);

Parameter

[in] plfoLog

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

[in] cContainers

Die Anzahl der Container in der Gruppe. Dies ist die Anzahl der Elemente im rgwszContainerPath-Array .

[in] rgwszContainerPath

Ein Zeiger auf ein Array von UNICODE_STRING Strukturen, von denen jede den Pfadnamen für einen der zu entfernenden Container bereitstellt. Die Anzahl der Elemente im Array wird von cContainers angegeben. Ein angegebener Pfad kann absolut oder relativ zum Speicherort der Basisprotokolldatei für das durch plfoLog dargestellte CLFS-Protokoll sein. 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

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

Hinweise

Das erzwungene Entfernen von Containern (fForce = TRUE) ist nur erfolgreich, wenn die zu entfernenden Container nicht Teil des aktiven Protokolls sind.

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

Anforderungen

Weitere Informationen

ClfsAddLogContainerSet

ClfsCreateLogFile

ClfsRemoveLogContainer

LOG_FILE_OBJECT

UNICODE_STRING