通过

TxfLogReadRecords 函数 (txfw32.h)

  • 项目

[Microsoft 强烈建议开发人员使用替代方法来实现应用程序的需求。 TxF 致力于实现的许多方案都可以通过更简单、更易用的技术来实现。 此外，TxF 在 Microsoft Windows 的将来版本中可能不可用。 有关详细信息，以及 TxF 的替代方法，请参阅事务性 NTFS 的替代方法。]

从日志中读取重做记录。

语法

BOOL TxfLogReadRecords(
  [in]  PVOID  TxfLogContext,
  [in]  ULONG  BufferLength,
  [out] PVOID  Buffer,
  [out] PULONG BytesUsed,
  [out] PULONG RecordCount
);

参数

[in] TxfLogContext

指向上下文的指针。

[in] BufferLength

输出缓冲区的大小（以字节为单位）。

[out] Buffer

指向接收记录的缓冲区的指针。 有关详细信息，请参阅 TXF_LOG_RECORD_BASE。

[out] BytesUsed

写入到输出缓冲区的字节数。

[out] RecordCount

写入到输出缓冲区的记录数。

返回值

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

如果函数失败，则返回值为零。 要获得更多的错误信息，请调用 GetLastError。 可能的错误代码包括以下内容。

返回代码 说明
ERROR_INVALID_HANDLE
 复制上下文无效。
ERROR_MORE_DATA
 某些可用记录已复制到缓冲区中。 再次调用此函数以检索其余记录。
ERROR_INSUFFICIENT_BUFFER
 缓冲区不够大，甚至不能包含一条记录。 如果 BytesUsed 为非零值，则有足够的空间来复制 TXF_LOG_RECORD_BASE 结构，这表示读取下一条完整记录所需的缓冲区大小。
ERROR_FILE_CORRUPT
 无法识别正在处理的日志文件的格式。

要求

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

另请参阅

TXF_LOG_RECORD_BASE