共用方式為


ClfsCloseLogFileObject 函式 (wdm.h)

ClfsCloseLogFileObject 例程會釋放對記錄檔物件的所有參考。

語法

CLFSUSER_API NTSTATUS ClfsCloseLogFileObject(
  [in] PLOG_FILE_OBJECT plfoLog
);

參數

[in] plfoLog

將發行參考之 LOG_FILE_OBJECT 結構的指標。呼叫者先前透過呼叫clfsCreateLogFile 來取得此指標,

傳回值

ClfsCloseLogFileObject 如果成功,就會傳回STATUS_SUCCESS;否則,它會傳回 Ntstatus.h 中定義的其中一個錯誤碼。

言論

ClfsCloseLogFileObject 會將CLFS取得的所有參考發行至指定的記錄檔物件。 一般而言,用戶端不會取得對記錄檔物件的任何其他參考。 不過,如果用戶端已取得其他參考,客戶端必須負責釋放它們。

ClfsCloseLogFileObject 會使指定的記錄檔對象的參考計數降至零,此時記錄檔物件已關閉(也就是其記憶體已解除分配)。 不過,記錄檔物件所代表的數據流可能會保持開啟狀態,因為可能有其他代表相同數據流的記錄檔物件。 在代表數據流的所有記錄檔物件關閉之後,數據流會關閉。

從這個例程傳回時,plfoLog 無效。

如需 CLFS 概念和術語的說明,請參閱 Common Log File System

要求

要求 價值
最低支援的用戶端 適用於 Windows Server 2003 R2、Windows Vista 和更新版本的 Windows。
目標平臺 桌面
標頭 wdm.h (包括 Wdm.h)
連結庫 Clfs.lib
DLL Clfs.sys
IRQL <= APC_LEVEL

另請參閱

ClfsCloseAndResetLogFile

ClfsCreateLogFile