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 |