共用方式為


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 概念和術語的說明,請參閱 Common Log File System

clfsSetEndOfLog 核心模式例程會保留供日後使用,目前一律會傳回STATUS_NOT_SUPPORTED。 不過,目前支持使用者模式例程 SetEndOfLog

要求

要求 價值
最低支援的用戶端 適用於 Windows Server 2003 R2、Windows Vista 和更新版本的 Windows。
目標平臺 桌面
標頭 wdm.h (包括 Wdm.h)
連結庫 Clfs.lib
DLL Clfs.sys
IRQL <= APC_LEVEL

另請參閱

CLFS_LSN

ClfsAdvanceLogBase

ClfsCreateLogFile

ClfsSetArchiveTail

ClfsSetEndOfLog

LOG_FILE_OBJECT