次の方法で共有

INapSystemHealthAgentBinding::Initialize メソッド

  • [アーティクル]

Note

ネットワーク アクセス保護プラットフォームは、Windows 10 以降は使用できません

INapSystemHealthAgentBinding::Initialize メソッドは、システム正常性エージェント (SHA) を初期化し、SHA を NapAgent サービスにバインドします。 このメソッドは、 INapSystemHealthAgentBinding2 インターフェイスで他のメソッドを呼び出す前に呼び出す必要があります。

構文

HRESULT Initialize(
  [in] SystemHealthEntityId          id,
  [in] INapSystemHealthAgentCallback *callback
);

パラメーター

id [in]

NapAgent サービスにバインドされている SHA の ID を含む一意の SystemHealthEntityId 。

callback [in]

NapAgent が通知/プロセスを使用して正常性エージェントをコールバックするために使用する INapSystemHealthAgentCallback インターフェイスへの COM ポインター。 NapAgent は、 Uninitialize が呼び出されるまで、このインターフェイスに関連付けられているオブジェクトへの参照を保持します。

戻り値

他の COM 固有のエラー コードも返される場合があります。

リターン コード 説明
S_OK
操作に成功しました。
E_ACCESSDENIED
アクセス許可エラー、アクセスが拒否されました。
E_OUTOFMEMORY
システム リソースの制限。操作を実行できませんでした。
ERROR_ALREADY_INITIALIZED
 SHA が以前に初期化されている場合、このエラーが返されます。
NAP_E_NOT_REGISTERED
 SHA が以前に登録されていない場合は、このエラーが返されます。
RPC_E_DISCONNECTED
 NapAgent が停止しました。 このオブジェクトは自動的に回復し、再起動後に NapAgent に再バインドされます。

解説

NapAgent は、初期化の結果として SoH 交換をトリガーしません。 システム正常性エージェントは NotifySoHChange を呼び出して、NapAgent で初期化した後に SoH パケットの交換を要求する必要があります。

要件

要件 値
サポートされている最小のクライアント
 Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows Server 2008 [デスクトップ アプリのみ]
ヘッダー
NapSystemHealthAgent.h
IDL
NapSystemHealthAgent.idl
[DLL]
Qagent.dll

関連項目

INapSystemHealthAgentBinding