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 |