clfsAdvanceLogBase 函式 (wdm.h)

ClfsAdvanceLogBase 例程會設定 CLFS 數據流的基底 LSN。

語法

CLFSUSER_API NTSTATUS ClfsAdvanceLogBase(
  [in, out] PVOID     pvMarshalContext,
  [in]      PCLFS_LSN plsnBase,
  [in]      ULONG     fFlags
);

[in, out] pvMarshalContext

不透明內容的指標，表示與CLFS數據流相關聯的封送處理區域。呼叫端先前藉由呼叫 ClfsCreateMarshallingArea 來取得此指標。

[in] plsnBase

包含新基底 LSN 之CLFS_LSN 結構的指標。此參數必須是數據流中其中一筆記錄的 LSN。此外，此參數必須大於或等於數據流的目前基底 LSN，且小於或等於數據流的目前最後一個 LSN。

[in] fFlags

此參數保留供系統使用。呼叫端必須將此參數設定為零。

ClfsAdvanceLogBase 如果成功，則會傳回STATUS_SUCCESS;否則，它會傳回 Ntstatus.h 中定義的其中一個錯誤碼。

ClfsAdvanceLogBase 不會將任何記錄寫入 CLFS 記錄;記錄檔的唯一更新位於元數據中。如果您想要更新基底 LSN 並將重新啟動記錄同時寫入數據流，請呼叫 ClfsWriteRestartArea。

盡可能避免 CLFS 將 LSN 小於新基底 LSN 的佇列記錄檔記錄寫入穩定記憶體。

ClfsAdvanceLogBase 不會檢查 plsnBase 中提供的 LSN 是否實際上是數據流中其中一筆記錄的 LSN。如果呼叫端將 plsnBase 設定為不是數據流中其中一筆記錄的 LSN，則數據流的基底 LSN 會設定為無意義的值。

如需CLFS概念和術語的說明，請參閱一般記錄檔系統。

需求	值
最低支援的用戶端	可在 Windows Server 2003 R2、Windows Vista 和更新版本的 Windows 中使用。
目標平台	桌面
標頭	wdm.h (包含 Wdm.h)
程式庫	Clfs.lib
Dll	Clfs.sys
IRQL	<= APC_LEVEL