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概念和術語的說明，請參閱 一般記錄檔系統。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 適用於 Windows Server 2003 R2、Windows Vista 和更新版本的 Windows。 |
| 目標平台 | 桌面 |
| 標頭 | wdm.h (包含 Wdm.h) |
| 程式庫 | Clfs.lib |
| Dll | Clfs.sys |
| IRQL | <= APC_LEVEL |