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