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 で使用できます。
対象プラットフォーム デスクトップ
Header wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
Library Clfs.lib
[DLL] Clfs.sys
IRQL <= APC_LEVEL

こちらもご覧ください

CLFS_MGMT_CLIENT_REGISTRATION

LOG_FILE_OBJECT