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 |