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 が実際にストリーム内のレコードの 1 つの LSN であるかどうかを確認 しません。 呼び出し元 plsnBase をストリーム内のレコードの 1 つの LSN ではない LSN に設定すると、ストリームのベース LSN は意味のない値に設定されます。

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

必要条件

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

関連項目

ClfsWriteRestartArea の