ClfsCloseAndResetLogFile-Funktion (wdm.h)

Die ClfsCloseAndResetLogFile-Routine gibt alle Verweise auf ein angegebenes Protokolldateiobjekt frei und markiert den zugeordneten Stream zum Zurücksetzen.

Syntax

CLFSUSER_API NTSTATUS ClfsCloseAndResetLogFile(
  [in] PLOG_FILE_OBJECT plfoLog
);

Parameter

[in] plfoLog

Ein Zeiger auf eine LOG_FILE_OBJECT-Struktur , für die Verweise freigegeben werden. Der Aufrufer hat diesen Zeiger zuvor durch Aufrufen von ClfsCreateLogFile abgerufen.

Rückgabewert

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

Hinweise

ClfsCloseAndResetLogFile gibt alle von CLFS abgerufenen Verweise auf das angegebene Protokolldateiobjekt frei. In der Regel hat der Client keine zusätzlichen Verweise auf das Protokolldateiobjekt erworben. Wenn der Client jedoch zusätzliche Verweise abgerufen hat, liegt es in der Verantwortung des Clients, diese freizugeben.

ClfsCloseAndResetLogFile bewirkt, dass die Referenzanzahl des angegebenen Protokolldateiobjekts auf 0 abgesetzt wird, wobei das Protokolldateiobjekt geschlossen wird (d. a. dessen Speicher wird zugeordnet). Der durch das Protokolldateiobjekt dargestellte Stream wird jedoch möglicherweise nicht zurückgesetzt, da es möglicherweise andere Protokolldateiobjekte gibt, die denselben Stream darstellen. Der Stream wird zurückgesetzt, nachdem alle Protokolldateiobjekte, die den Stream darstellen, geschlossen wurden (z. B. durch Aufrufe von ClfsCloseLogFileObject).

Ein Zurücksetzungsstream ähnelt einem neu erstellten Stream, für den noch nie Datensätze geschrieben wurden.

Bei der Rückkehr von dieser Routine ist plfoLog ungültig.

Sie können ClfsCloseAndResetLogFile für einen bestimmten Stream maximal 124 Mal aufrufen.

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

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 (einschließen von Wdm.h)
Bibliothek	Clfs.lib
DLL	Clfs.sys
IRQL	<= APC_LEVEL

Weitere Informationen

ClfsCloseLogFileObject

ClfsDeleteLogByPointer

ClfsDeleteLogFile