ClfsDeleteLogFile-Funktion (wdm.h)
Die ClfsDeleteLogFile-Routine markiert einen CLFS-Stream 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 Stream eines dedizierten Protokolls ist, hat der Name die Form log:physical log name, wobei name des physischen Protokolls der Pfadname des physischen Protokolls im zugrunde liegenden Dateisystem ist.
Wenn der zu löschende Stream einer der Streams eines Multiplexprotokolls ist, hat der Name die Form log:physical log:physical log name::stream name, wobei der name des physischen Protokolls der Pfadname des physischen Protokolls im zugrunde liegenden Dateisystem und der Streamname 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 der möglichen 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 vom 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 0 sein.
Rückgabewert
ClfsDeleteLogFile gibt bei Erfolg STATUS_SUCCESS zurück. Andernfalls wird einer der in "Ntstatus.h" definierten Fehlercodes zurückgegeben.
Hinweise
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 Membern finden Sie unter FILE_OBJECT.
ClfsDeleteLogFile markiert einen Datenstrom zum Löschen, schließt jedoch keine Protokolldateiobjekte, die derzeit geöffnet sind. Um ein Protokolldateiobjekt zu schließen, rufen Sie ClfsCloseLogFileObject auf. Ein zum Löschen markierter Stream wird gelöscht, nachdem alle dem Datenstrom zugeordneten Protokolldateiobjekte geschlossen wurden.
Ein CLFS-Stream, der zum Löschen markiert ist, 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( 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 |