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

出力バッファーに書き込まれたレコードの数。

戻り値

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。 考えられるエラー コードは次のとおりです。

リターン コード 説明
ERROR_INVALID_HANDLE
 レプリケーション コンテキストが無効です。
ERROR_MORE_DATA
 使用可能なレコードの一部がバッファーにコピーされました。 この関数をもう一度呼び出して、残りのレコードを取得します。
ERROR_INSUFFICIENT_BUFFER
 バッファーは、1 つのレコードを格納するのに十分な大きさではありません。 BytesUsed が 0 以外の場合は、次の完全なレコードを読み取るために必要なバッファー サイズを示す、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