ClfsSetLogFileInformation 関数 (wdm.h)

[アーティクル]
02/27/2024

ClfsSetLogFileInformation ルーチンは、指定されたストリームとその基になる物理ログのメタデータと状態情報を設定します。

構文

CLFSUSER_API NTSTATUS ClfsSetLogFileInformation(
  [in] PLOG_FILE_OBJECT           plfoLog,
  [in] CLFS_LOG_INFORMATION_CLASS eInformationClass,
  [in] PVOID                      pinfoBuffer,
  [in] ULONG                      cbBuffer
);

パラメーター

[in] plfoLog

CLFS ストリームを表す LOG_FILE_OBJECT 構造体へのポインター。呼び出し元は、以前に ClfsCreateLogFile を呼び出してこのポインターを取得しました。

[in] eInformationClass

設定する情報のクラスを指定する CLFS_LOG_INFORMATION_CLASS 値。

[in] pinfoBuffer

ログ情報を提供するバッファーへのポインター。このバッファーの構造は、 eInformationClass で指定された情報のクラスによって異なります。次の表は、情報クラスとバッファー型の関係を示しています。

eInformationClass の値	pinfoBuffer が指すバッファーの種類
ClfsLogBasicInformation	CLFS_INFORMATION
ClfsLogBasicInformationPhysical	CLFS_INFORMATION
ClfsLogNameInformation	CLFS_LOG_NAME_INFORMATION
ClfsLogPhysicalNameInformation	CLFS_LOG_NAME_INFORMATION
ClfsLogStreamIdentifierInformation	CLFS_STREAM_ID_INFORMATION

[in] cbBuffer

pinfoBuffer が指すバッファーのサイズ (バイト単位)。

戻り値

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

注釈

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

要件

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