ClfsRemoveLogContainerSet-Funktion (wdm.h)
Das ClfsRemoveLogContainerSet routinemäßig eine Reihe von Containern aus einem CLFS-Protokoll entfernt.
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 ClfsCreateLogFileabgerufen.
[in] cContainers
Die Anzahl der Container im Satz. Dies ist die Anzahl der Elemente im rgwszContainerPath Array.
[in] rgwszContainerPath
Ein Zeiger auf ein Array von UNICODE_STRING Strukturen, von denen jeder den Pfadnamen für einen der zu entfernenden Container bereitstellt. Die Anzahl der Elemente im Array wird durch cContainersangegeben. Ein bestimmter Pfad kann absolut oder relativ zum Speicherort der Basisprotokolldatei für das CLFS-Protokoll sein, das durch plfoLogdargestellt wird. Pfade, die relativ zur Basisprotokolldatei sind, müssen mit CLFS_CONTAINER_RELATIVE_PREFIX beginnen. Dies ist das Zeichenfolgenliteral (L"%BLF%\"). Die Verzeichnisse "." und "." sind in einem relativen Pfad nicht zulässig.
[in] fForce
Ein boolescher Wert, der angibt, ob die Containerentfernung erzwungen wird (TRUE) oder faul (FALSE).
Rückgabewert
ClfsRemoveLogContainerSet gibt STATUS_SUCCESS zurück, wenn dies erfolgreich ist; andernfalls wird eine der fehlercodes zurückgegeben, die in Ntstatus.h definiert sind.
Bemerkungen
Erzwungene Containerentfernung (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 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 |