次の方法で共有

ClfsMgmtRegisterManagedClient 関数 (wdm.h)

  • [アーティクル]

ClfsMgmtRegisterManagedClient ルーチンは、CLFS ログを管理するクライアントを作成します。

構文

CLFSUSER_API NTSTATUS ClfsMgmtRegisterManagedClient(
  [in] PLOG_FILE_OBJECT               LogFile,
  [in] PCLFS_MGMT_CLIENT_REGISTRATION RegistrationData,
       PCLFS_MGMT_CLIENT              ClientCookie
);

パラメーター

[in] LogFile

ClfsMgmtRegisterManagedClient によって作成されたクライアントが管理する CLFS ログ ストリームを表す LOG_FILE_OBJECT 構造体へのポインター。

[in] RegistrationData

ログの管理に使用される関数を含む CLFS_MGMT_CLIENT_REGISTRATION 構造体のインスタンス。

ClientCookie

今後 API を使用するために呼び出し元に返す Cookie。

戻り値

ClfsMgmtRegisterManagedClient ルーチンは、次のいずれかの NTSTATUS 値を返します。

リターン コード 形容
STATUS_SUCCESS
 ログを管理するためのクライアントが作成されました。
STATUS_UNSUCCESSFUL
 CLFS 管理では、ログを管理するクライアントを作成できませんでした。
STATUS_INSUFFICIENT_RESOURCES
 操作を完了するためのメモリが不足しています。
STATUS_INVALID_PARAMETER
 入力パラメーターが無効です。
 

このルーチンは、他の NTSTATUS 値を返す場合もあります。

備考

ClfsMgmtRegisterManagedClient ルーチンによって提供される Client パラメーターは、他の CLFS 管理機能に必要なパラメーターです。 後で使用するために、この値を格納する必要があります。

クライアント アプリケーションは、ClfsMgmtRegisterManagedClient ルーチンを呼び出すとすぐにコールバック ルーチンを呼び出す準備ができている必要があります。

複数のクライアントをログ ストリームに登録できます。

必要条件

要件 価値
サポートされる最小クライアント Windows Server 2003 R2、Windows Vista、およびそれ以降のバージョンの Windows で使用できます。
ターゲット プラットフォーム の デスクトップ
ヘッダー wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
ライブラリ Clfs.lib
DLL Clfs.sys
IRQL <= APC_LEVEL

関連項目

CLFS_MGMT_CLIENT_REGISTRATION

LOG_FILE_OBJECT