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 erhalten 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

Weitere Informationen

ClfsCloseAndResetLogFile

ClfsCreateLogFile