ClfsDeleteLogFile-Funktion (wdm.h)
Die ClfsDeleteLogFile Routine kennzeichnet einen CLFS-Datenstrom zum Löschen.
Syntax
CLFSUSER_API NTSTATUS ClfsDeleteLogFile(
[in] PUNICODE_STRING puszLogFileName,
PVOID pvReserved,
[in] ULONG fLogOptionFlag,
[in, optional] PVOID pvContext,
[in] ULONG cbContext
);
Parameter
[in] puszLogFileName
Ein Zeiger auf eine UNICODE_STRING-Struktur, die den Namen des zu löschenden CLFS-Datenstroms bereitstellt.
Wenn der zu löschende Datenstrom der einzige Datenstrom eines dedizierten Protokolls ist, weist der Name das Formularprotokoll auf:physischen Protokollnamen, wobei physischen Protokollnamen der Pfadname des physischen Protokolls im zugrunde liegenden Dateisystem ist.
Wenn der zu löschende Datenstrom einer der Datenströme eines Multiplexed-Protokolls ist, weist der Name das Formularprotokoll auf:physischer Protokollname::Datenstromname, wobei physische Protokollname der Pfadname des physischen Protokolls im zugrunde liegenden Dateisystem ist und Datenstromname der eindeutige Name des zu löschenden Datenstroms ist.
pvReserved
Reserviert.
[in] fLogOptionFlag
Ein Wert, der die Beziehung zwischen CLFS und der Komponente angibt, die das Protokoll löscht. Eine Liste möglicher Werte finden Sie in der Beschreibung des fLogOptionFlag- Parameters der ClfsCreateLogFile Routine.
[in, optional] pvContext
Ein Zeiger auf einen Kontext. Die Art und Weise, wie der Kontext interpretiert wird, hängt von dem wert ab, der in fLogOptionFlagübergeben wird.
[in] cbContext
Die Größe des Kontexts in Bytes, auf den pvContext verweist. Wenn pvContext- nicht NULL-ist, muss dieser Parameter größer als Null sein.
Rückgabewert
ClfsDeleteLogFile- gibt STATUS_SUCCESS zurück, wenn sie erfolgreich ist; andernfalls wird eine der fehlercodes zurückgegeben, die in Ntstatus.h definiert sind.
Bemerkungen
Das Common Log File System (CLFS) verwendet die LOG_FILE_OBJECT Struktur, um Protokolle darzustellen. Die ClfsCreateLogFile--Funktion gibt einen Zeiger auf LOG_FILE_OBJECT zurück, den Clients dann an andere CLFS-Funktionen übergeben.
CLFS-Clients greifen nicht direkt auf die Member einer LOG_FILE_OBJECT Struktur zu. Informationen zu den Mitgliedern finden Sie unter FILE_OBJECT.
ClfsDeleteLogFile markiert einen Datenstrom zum Löschen, schließt jedoch keine Protokolldateiobjekte, die derzeit geöffnet sind. Rufen Sie zum Schließen eines Protokolldateiobjekts ClfsCloseLogFileObjectauf. Ein zum Löschen markierter Datenstrom wird gelöscht, nachdem alle dem Datenstrom zugeordneten Protokolldateiobjekte geschlossen wurden.
Ein zum Löschen markierter CLFS-Datenstrom lehnt nachfolgende Anforderungen zum Öffnen des Datenstroms ab.
Der Name eines physischen CLFS-Protokolls enthält nicht die BLF-Erweiterung.
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 |