ClfsCloseAndResetLogFile-Funktion (wdm.h)
Die ClfsCloseAndResetLogFile Routine gibt alle Verweise auf ein angegebenes Protokolldateiobjekt frei und markiert den zugeordneten Datenstrom 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 ClfsCreateLogFileabgerufen.
Rückgabewert
ClfsCloseAndResetLogFile gibt STATUS_SUCCESS zurück, wenn sie erfolgreich ist; andernfalls wird eine der fehlercodes zurückgegeben, die in Ntstatus.h definiert sind.
Bemerkungen
ClfsCloseAndResetLogFile alle Von CLFS erworbenen 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 erhalten hat, liegt es in der Verantwortung des Kunden, sie freizugeben.
ClfsCloseAndResetLogFile- bewirkt, dass die Referenzanzahl des angegebenen Protokolldateiobjekts auf Null fällt, zu dem zeitpunkt, zu dem das Protokolldateiobjekt geschlossen wird (d. a. der Speicher wird zugeordnet). Der durch das Protokolldateiobjekt dargestellte Datenstrom kann jedoch nicht zurückgesetzt werden, da es andere Protokolldateiobjekte geben könnte, die denselben Datenstrom darstellen. Der Datenstrom wird zurückgesetzt, nachdem alle Protokolldateiobjekte, die den Datenstrom darstellen, geschlossen werden (z. B. durch Aufrufe von ClfsCloseLogFileObject).
Ein Zurücksetzungsstream ist wie ein neu erstellter Datenstrom, der noch nie Datensätze in den Datenstrom geschrieben hat.
Bei rückgabe dieser Routine ist plfoLog ungültig.
Sie können ClfsCloseAndResetLogFile- höchstens 124 Mal für einen bestimmten Datenstrom aufrufen.
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 |