通过

AddLogContainer 函数 (clfsw32.h)

  • 项目

如果调用进程对 .blf 文件具有写入访问权限，并且能够在容器的目标目录中创建文件，则向与日志句柄关联的物理日志中添加容器。

此函数不同于 AddLogContainerSet，因为它只添加一个容器。 若要添加多个容器，使用 AddLogContainerSet 可以更高效地添加多个容器。 添加容器允许客户端增加日志的大小。

语法

CLFSUSER_API BOOL AddLogContainer(
  [in]                HANDLE     hLog,
  [in, optional]      PULONGLONG pcbContainer,
  [in]                LPWSTR     pwszContainerPath,
  [in, out, optional] LPVOID     pReserved
);

参数

[in] hLog

打开日志的句柄。

必须从对日志具有写入访问权限的 CreateLogFile 获取句柄。 客户端应用程序必须具有对 .blf 文件的写入访问权限，并且能够在容器的目标目录中创建文件。

[in, optional] pcbContainer

指定容器大小的可选参数（以字节为单位）。

正常日志的最小大小为 512 KB，多路复用日志的最小大小为 1024 KB。 最大大小约为 4 GB。

如果将容器添加到新创建的日志，则此参数是必需的。 如果已创建容器，此参数可以是 NULL，也可以是至少与第一个容器的大小一样大的值。

日志容器大小是日志区域大小的倍数， (512 KB) 。 将容器添加到新文件时， AddLogContainer 函数会将容器的大小舍入到下一个 512 KB 边界，并在 由 dpcContainer 指向的值中返回该大小。

同样，如果日志已具有至少一个容器，并且 *b.dcontainer 的值至少与当前容器大小一样大，则 函数将创建具有当前内部大小的所有容器，并在 *ddContainer 中返回该大小。

[in] pwszContainerPath

指向以 null 结尾的字符串的指针，该字符串包含日志卷上新容器的有效路径。

[in, out, optional] pReserved

保留。 将 pReserved 设置为 NULL。

返回值

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

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

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

要求

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

另请参阅

AddLogContainerSet

常见日志文件系统函数

CreateLogFile