TruncateLog 函数 (clfsw32.h)

截断日志。 函数将日志的末尾设置为指定的值。

语法

CLFSUSER_API BOOL TruncateLog(
  [in]                PVOID        pvMarshal,
  [in]                PCLFS_LSN    plsnEnd,
  [in, out, optional] LPOVERLAPPED lpOverlapped
);

参数

[in] pvMarshal

指向通过调用 CreateLogMarshallingArea 函数分配的不透明封送上下文的指针。

[in] plsnEnd

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

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

[in, out, optional] lpOverlapped

保留。 将 “保留” 设置为 NULL

返回值

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

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

注解

如果卷扇区大小大于 512 字节, 则 TruncateLog 返回ERROR_NOT_SUPPORTED。

要求

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

另请参阅

CLFS_LSN

常见日志文件系统函数

OVERLAPPED