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 |