ClfsAdvanceLogBase 関数 (wdm.h)
ClfsAdvanceLogBase ルーチンは、CLFS ストリームの基本 LSN を設定します。
構文
CLFSUSER_API NTSTATUS ClfsAdvanceLogBase(
[in, out] PVOID pvMarshalContext,
[in] PCLFS_LSN plsnBase,
[in] ULONG fFlags
);
パラメーター
[in, out] pvMarshalContext
CLFS ストリームに関連付けられたマーシャリング領域を表す不透明なコンテキストへのポインター。 呼び出し元は、以前に ClfsCreateMarshallingArea を呼び出してこのポインターを取得しました。
[in] plsnBase
新しい基本 LSN を含む CLFS_LSN 構造体へのポインター。 このパラメーターは、ストリーム内のいずれかのレコードの LSN である必要があります。 また、このパラメーターは、ストリームの現在のベース LSN 以上で、ストリームの現在の最後の LSN 以下である必要があります。
[in] fFlags
このパラメーターは、システムで使用するために予約されています。 呼び出し元は、このパラメーターを 0 に設定する必要があります。
戻り値
ClfsAdvanceLogBase は、成功した場合STATUS_SUCCESSを返します。それ以外の場合は、Ntstatus.h で定義されているエラー コードのいずれかを返します。
注釈
ClfsAdvanceLogBase では、CLFS ログにレコードは書き込まれません。ログに対する唯一の更新はメタデータにあります。 ベース LSN を更新し、同時にストリームに再起動レコードを書き込む場合 は、ClfsWriteRestartArea を呼び出します。
CLFS は、可能な限り、新しいベース LSN より小さい LSN を持つキューに入ったログ レコードを安定したストレージに書き込むのを回避します。
ClfsAdvanceLogBase では、plsnBase で提供される LSN が実際にストリーム内のいずれかのレコードの LSN であるかどうかを確認するチェックはありません。 呼び出し元が plsnBase をストリーム内のレコードの 1 つの LSN ではない LSN に設定した場合、ストリームのベース LSN は意味のない値に設定されます。
CLFS の概念と用語の説明については、「 共通ログ ファイル システム」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Server 2003 R2、Windows Vista、およびそれ以降のバージョンの Windows で使用できます。 |
| 対象プラットフォーム | デスクトップ |
| Header | wdm.h (Wdm.h を含む) |
| Library | Clfs.lib |
| [DLL] | Clfs.sys |
| IRQL | <= APC_LEVEL |