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 |