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。
盡可能避免將 LSN 小於新基底 LSN 的佇列記錄檔記錄寫入穩定記憶體。
ClfsAdvanceLogBase 不會檢查 plsnBase 中提供的 LSN 是否實際上是數據流中其中一筆記錄的 LSN。 如果呼叫端將 plsnBase 設定為 LSN，該 LSN 不是數據流中其中一筆記錄的 LSN，則數據流的基底 LSN 會設定為毫無意義的值。
如需 CLFS 概念和術語的說明，請參閱 Common Log File System。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | 適用於 Windows Server 2003 R2、Windows Vista 和更新版本的 Windows。 |
| 目標平臺 | 桌面 |
| 標頭 | wdm.h （包括 Wdm.h） |
| 連結庫 | Clfs.lib |
| DLL | Clfs.sys |
| IRQL | <= APC_LEVEL |