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

另請參閱

ClfsCloseLogFileObject

ClfsDeleteLogByPointer

ClfsDeleteLogFile