getLogFileInformation 函数 (clfsw32.h)

返回一个缓冲区,该缓冲区包含有关指定日志及其当前状态的元数据,该 状态由 CLFS_INFORMATION 结构定义。

获取的数据仅反映调用时日志的状态。 通常,客户端可以继续缓存和使用此结构中的字段,直到下次追加记录或写入其重启区域。 当时,某些信息已过时。

语法

CLFSUSER_API BOOL GetLogFileInformation(
  [in]      HANDLE            hLog,
  [in, out] PCLFS_INFORMATION pinfoBuffer,
  [in, out] PULONG            cbBuffer
);

参数

[in] hLog

从成功调用 CreateLogFile 获取的打开日志的句柄。

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

[in, out] pinfoBuffer

指向接收日志元数据的用户分配 CLFS_INFORMATION 结构的指针。

[in, out] cbBuffer

指向变量的指针,该变量在输入上指定 pinfoBuffer 指向的元数据缓冲区的大小(以字节为单位)。

在输出时,它指定实际复制到 pinfoBuffer 中的字节数。

返回值

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

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

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

要求

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

另请参阅

CLFS_INFORMATION

常见日志文件系统函数

CreateLogFile

获取下一个 LSN