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