共用方式為

TxfLogReadRecords 函式 (txfw32.h)

  • 發行項

[Microsoft 強烈建議開發人員利用替代方法來達成應用程式的需求。 許多針對 TxF 開發的案例，都可以透過更簡單且更容易取得的技術來達成。 此外，未來版本的 Microsoft Windows 可能無法使用 TxF。 如需詳細資訊，以及 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。 可能的錯誤碼包括下列專案。

傳回碼 Description
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
程式庫 TxfW32.lib
Dll TxfW32.dll

另請參閱

TXF_LOG_RECORD_BASE