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 |