SetEndOfLog 函数 (clfsw32.h)

此函数已弃用。 请改用 TruncateLog

语法

CLFSUSER_API BOOL SetEndOfLog(
  [in]                HANDLE       hLog,
  [in]                PCLFS_LSN    plsnEnd,
  [in, out, optional] LPOVERLAPPED lpOverlapped
);

参数

[in] hLog

CreateLogFile 获取的日志的句柄。

日志句柄必须引用专用日志。

[in] plsnEnd

指向 CLFS_LSN 结构的指针,该结构指定日志的新末尾。

LSN 必须在基本日志序列号 (日志的 LSN) 与日志的最后一个 LSN 之间。

[in, out, optional] lpOverlapped

保留。 将 lpOverlapped 设置为 NULL

返回值

如果该函数成功,则返回值为非零值。

如果函数失败,则返回值为零。 要获得更多的错误信息,请调用 GetLastError。 以下列表标识了可能的错误代码:

注解

SetEndOfLog 函数通过将日志的末尾设置为指定值来截断日志。 此操作仅适用于专用日志。

SetEndOfLog 只能用于截断日志。

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 R2 [仅限桌面应用]
目标平台 Windows
标头 clfsw32.h
Library Clfsw32.lib
DLL Clfsw32.dll

另请参阅

CLFS_LSN

常见日志文件系统函数

OVERLAPPED