次の方法で共有


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