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 の概念と用語の説明については、「 共通ログ ファイル システム」を参照してください。

要件

こちらもご覧ください

ClfsWriteRestartArea