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