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 von ClfsCreateLogFile abgerufen.
Rückgabewert
ClfsCloseLogFileObject gibt bei Erfolg STATUS_SUCCESS zurück. Andernfalls wird einer der in "Ntstatus.h" definierten Fehlercodes zurückgegeben.
Hinweise
ClfsCloseLogFileObject 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.
ClfsCloseLogFileObject bewirkt, dass die Verweisanzahl des angegebenen Protokolldateiobjekts auf 0 abgesetzt wird, wobei das Protokolldateiobjekt geschlossen wird (das heißt, sein Arbeitsspeicher wird zugeordnet). Der durch das Protokolldateiobjekt dargestellte Stream bleibt jedoch möglicherweise geöffnet, da es andere Protokolldateiobjekte geben kann, die denselben Stream darstellen. Der Stream wird geschlossen, nachdem alle Protokolldateiobjekte, die den Stream darstellen, geschlossen wurden.
Bei der Rückkehr von dieser Routine ist plfoLog ungültig.
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 |