ClfsDeleteLogFile-Funktion (wdm.h)

  • Artikel

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

Weitere Informationen

ClfsCloseAndResetLogFile

ClfsCloseLogFileObject

ClfsCreateLogFile

ClfsDeleteLogByPointer