ClfsReadNextLogRecord 関数 (wdm.h)

ClfsReadNextLogRecord ルーチンは、読み取りコンテキストの現在のレコードを基準にして、シーケンス内の次のレコードを読み取ります。

構文

CLFSUSER_API NTSTATUS ClfsReadNextLogRecord(
  [in, out]      PVOID             pvReadContext,
  [out]          PVOID             *ppvBuffer,
  [out]          PULONG            pcbBuffer,
  [in, out]      PCLFS_RECORD_TYPE peRecordType,
  [in, optional] PCLFS_LSN         plsnUser,
  [out]          PCLFS_LSN         plsnUndoNext,
  [out]          PCLFS_LSN         plsnPrevious,
  [out]          PCLFS_LSN         plsnRecord
);

パラメーター

[in, out] pvReadContext

呼び出し元が ClfsReadLogRecord または ClfsReadRestartArea を呼び出して以前に取得した読み取りコンテキストへのポインター。

[out] ppvBuffer

レコード データを含むバッファーへのポインターを受け取る変数へのポインター。

[out] pcbBuffer

*ppvBuffer が指すバッファーのサイズ (バイト単位) を受け取る ULONG 型の変数へのポインター。 これは、読み取られたレコードのデータ バッファーの長さです。

[in, out] peRecordType

CLFS_RECORD_TYPE型の変数へのポインター。 呼び出し元は、このパラメーターを次のいずれかの値に設定する必要があります。

値	読み取られるレコード
ClfsDataRecord	次のデータ レコード。
ClfsRestartRecord	次の再起動レコード。
ClfsClientRecord	データ レコードまたは再起動レコードの次のレコード。

[in, optional] plsnUser

読み取るレコードの LSN を提供する CLFS_LSN 構造体へのポインター。 指定されたレコードは、読み取りコンテキスト (pvReadContext) のモード (ClfsContextUndoNext、ClfsContextPrevious、または ClfsContextForward) に従って読み取られたレコードの代わりに読み取られます。 plsnUser で提供される LSN は、読み取りコンテキストの現在の LSN より小さい必要があります。 このパラメーターは、NULL でもかまいません。

[out] plsnUndoNext

読み 取られたレコード の元に戻す次の LSN を受け取るCLFS_LSN構造体へのポインター。

[out] plsnPrevious

読み取られた レコードの前 の LSN を受け取るCLFS_LSN構造体へのポインター。

[out] plsnRecord

読み 取られたレコード の LSN を受け取るCLFS_LSN構造体へのポインター。

戻り値

ClfsReadNextLogRecord は 、成功した場合STATUS_SUCCESSを返します。それ以外の場合は、Ntstatus.h で定義されているエラー コードのいずれかを返します。

注釈

CLFS の概念と用語の詳細については、「 共通ログ ファイル システム」を参照してください。

CLFS ストリームからレコードを読み取る方法については、「CLFS Streamからのデータ レコードの読み取り」および「CLFS Streamからの再開レコードの読み取り」を参照してください。

読み取りコンテキストはスレッド セーフではありません。 クライアントは、読み取りコンテキストへのアクセスをシリアル化する必要があります。

要件

要件	値
サポートされている最小のクライアント	Windows Server 2003 R2、Windows Vista、およびそれ以降のバージョンの Windows で使用できます。
対象プラットフォーム	デスクトップ
Header	wdm.h (Wdm.h を含む)
Library	Clfs.lib
[DLL]	Clfs.sys
IRQL	<= APC_LEVEL

こちらもご覧ください

CLFS_LSN

ClfsReadLogRecord

ClfsReadRestartArea