共用方式為


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