ClfsCloseLogFileObject-Funktion (wdm.h)
Die ClfsCloseLogFileObject Routine gibt alle Verweise auf ein Protokolldateiobjekt frei.
Syntax
CLFSUSER_API NTSTATUS ClfsCloseLogFileObject(
[in] PLOG_FILE_OBJECT plfoLog
);
Parameter
[in] plfoLog
Ein Zeiger auf die LOG_FILE_OBJECT Struktur, für die Verweise freigegeben werden. Der Aufrufer hat diesen Zeiger zuvor durch Aufrufen ClfsCreateLogFileabgerufen.
Rückgabewert
ClfsCloseLogFileObject gibt STATUS_SUCCESS zurück, wenn es erfolgreich ist; andernfalls wird eine der fehlercodes zurückgegeben, die in Ntstatus.h definiert sind.
Bemerkungen
ClfsCloseLogFileObject gibt 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.
ClfsCloseLogFileObject 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 bleibt möglicherweise geöffnet, da andere Protokolldateiobjekte vorhanden sein könnten, die denselben Datenstrom darstellen. Der Datenstrom wird geschlossen, nachdem alle Protokolldateiobjekte, die den Datenstrom darstellen, geschlossen sind.
Bei rückgabe dieser Routine ist plfoLog ungültig.
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 |