ClfsCloseAndResetLogFile 函式 (wdm.h)
ClfsCloseAndResetLogFile 例程會釋放指定記錄檔物件的所有參考,並標示其相關聯的數據流以進行重設。
語法
CLFSUSER_API NTSTATUS ClfsCloseAndResetLogFile(
[in] PLOG_FILE_OBJECT plfoLog
);
參數
[in] plfoLog
將發行參考之 LOG_FILE_OBJECT 結構的指標。 呼叫端先前透過呼叫 ClfsCreateLogFile 來取得此指標。
傳回值
ClfsCloseAndResetLogFile 如果成功,就會傳回STATUS_SUCCESS;否則,它會傳回 Ntstatus.h 中定義的其中一個錯誤碼。
言論
ClfsCloseAndResetLogFile 會將 CLFS 取得的所有參考發行至指定的記錄檔物件。 一般而言,用戶端不會取得對記錄檔物件的任何其他參考。 不過,如果用戶端已取得其他參考,客戶端必須負責釋放它們。
ClfsCloseAndResetLogFile 會導致指定的記錄檔對象的參考計數降至零,此時記錄檔物件已關閉(也就是其記憶體已解除分配)。 不過,記錄檔物件所代表的數據流可能不會重設,因為可能有其他代表相同數據流的記錄檔物件。 數據流會在代表數據流的所有記錄檔對象關閉之後重設 (例如,呼叫 clfsCloseLogFileObject)。
重設數據流就像新建立的數據流,該數據流從未寫入任何記錄。
從這個例程傳回時,plfoLog 無效。
您可以呼叫 ClfsCloseAndResetLogFile 指定數據流最多 124 次。
如需 CLFS 概念和術語的說明,請參閱 Common Log File System。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 適用於 Windows Server 2003 R2、Windows Vista 和更新版本的 Windows。 |
目標平臺 | 桌面 |
標頭 | wdm.h (包括 Wdm.h) |
連結庫 | Clfs.lib |
DLL | Clfs.sys |
IRQL | <= APC_LEVEL |