ClfsSetEndOfLog 関数 (wdm.h)

ClfsSetEndOfLog ルーチンは、CLFS ストリームを切り捨てます。

構文

CLFSUSER_API NTSTATUS ClfsSetEndOfLog(
  [in] PLOG_FILE_OBJECT plfoLog,
  [in] PCLFS_LSN        plsnEnd
);

パラメーター

[in] plfoLog

CLFS ストリームを表す LOG_FILE_OBJECT 構造体へのポインター。 このストリームは、専用ログの唯一のストリームである必要があります。 呼び出し元は、以前に ClfsCreateLogFile を呼び出してこのポインターを取得しました。

[in] plsnEnd

ストリームの最後のレコードになるレコードの LSN を提供する CLFS_LSN 構造体へのポインター。 これは、ストリーム内のいずれかのレコードの正確な LSN である必要があります。

戻り値

ClfsSetEndOfLog は 、成功した場合STATUS_SUCCESSを返します。それ以外の場合は、Ntstatus.h で定義されているエラー コードのいずれかを返します。

注釈

plsnEnd 値で指定された LSN は検証されません。 有効な LSN を指定するのは呼び出し元の責任です。つまり、ストリーム内のレコードの正確な LSN です。

plfoLog で表されるこのストリームは、専用ログからである必要があります。 このルーチンでは、多重化されたログからのストリームはサポートされていません。

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

カーネル モード ルーチン ClfsSetEndOfLog は将来使用するために予約されており、現在は常にSTATUS_NOT_SUPPORTEDを返します。 ただし、ユーザー モード ルーチン SetEndOfLog は現在サポートされています。

要件

要件
サポートされている最小のクライアント Windows Server 2003 R2、Windows Vista、およびそれ以降のバージョンの Windows で使用できます。
対象プラットフォーム デスクトップ
Header wdm.h (Wdm.h を含む)
Library Clfs.lib
[DLL] Clfs.sys
IRQL <= APC_LEVEL

こちらもご覧ください

CLFS_LSN

ClfsAdvanceLogBase

ClfsCreateLogFile

ClfsSetArchiveTail

ClfsSetEndOfLog

LOG_FILE_OBJECT