SetLogArchiveTail 函数 (clfsw32.h)

设置可存档日志 (LSN) 或 存档尾部 的最后一个存档日志序列号。

语法

CLFSUSER_API BOOL SetLogArchiveTail(
  [in]                HANDLE    hLog,
  [in]                PCLFS_LSN plsnArchiveTail,
  [in, out, optional] LPVOID    pReserved
);

参数

[in] hLog

CreateLogFile 获取的日志的句柄。

日志句柄可以引用专用日志或多路复用日志。

[in] plsnArchiveTail

指向 CLFS_LSN 结构的指针,该结构指定日志中的有效物理 LSN。

注意 对于物理日志或日志流的句柄, plsnArchiveTail 是物理 LSN,因为它引用物理日志中的记录地址。
 

[in, out, optional] pReserved

此参数是保留的,应设置为 NULL

返回值

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

如果函数失败,则返回值为零。 要获得更多的错误信息,请调用 GetLastError。

以下列表标识了可能的错误代码:

注解

如果从 PrepareLogArchive 获取的任何存档上下文未使用 TerminateLogArchive 终止,则在完成所有存档之前,更改才会生效。 尽管有未完成的存档上下文,但仅应用最大的存档尾部。

要求

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

另请参阅

CLFS_LSN

常见日志文件系统函数

OVERLAPPED

RemoveLogContainer

RemoveLogContainerSet