clfsSetEndOfLog 函式 (wdm.h)
ClfsSetEndOfLog 例程會截斷 CLFS 數據流。
語法
CLFSUSER_API NTSTATUS ClfsSetEndOfLog(
[in] PLOG_FILE_OBJECT plfoLog,
[in] PCLFS_LSN plsnEnd
);
參數
[in] plfoLog
表示 CLFS 數據流 之LOG_FILE_OBJECT 結構的指標。 此數據流必須是專用記錄的唯一數據流。 呼叫端先前藉由呼叫 ClfsCreateLogFile 來取得此指標。
[in] plsnEnd
CLFS_LSN 結構的指標 ,提供要成為數據流最後一筆記錄的記錄 LSN。 這必須是數據流中其中一筆記錄的確切 LSN。
傳回值
ClfsSetEndOfLog 如果成功,則會傳回STATUS_SUCCESS;否則,它會傳回 Ntstatus.h 中定義的其中一個錯誤碼。
備註
plsnEnd 值中提供的 LSN 不會經過驗證。 呼叫端必須負責提供有效的 LSN;也就是說,這是數據流中記錄的確切 LSN。
plfoLog 所代表的這個數據流必須來自專用記錄。 此例程不支援來自多任務記錄的數據流。
如需CLFS概念和術語的說明,請參閱 一般記錄檔系統。
核心模式例程 ClfsSetEndOfLog 保留供日後使用,目前一律會傳回STATUS_NOT_SUPPORTED。 不過,目前支持使用者模式例程 SetEndOfLog 。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 可在 Windows Server 2003 R2、Windows Vista 和更新版本的 Windows 中使用。 |
目標平台 | 桌面 |
標頭 | wdm.h (包含 Wdm.h) |
程式庫 | Clfs.lib |
Dll | Clfs.sys |
IRQL | <= APC_LEVEL |