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 の