INapSystemHealthAgentBinding::Initialize 方法

注意

网络访问保护平台从Windows 10开始不可用

INapSystemHealthAgentBinding::Initialize 方法 (SHA) 初始化系统运行状况代理,并将 SHA 绑定到 NapAgent 服务。 在 INapSystemHealthAgentBinding2 接口上调用任何其他方法之前,必须调用此方法。

语法

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

参数

id [in]

一个唯一 的 SystemHealthEntityId ,其中包含绑定到 NapAgent 服务的 SHA 的 ID。

callback [in]

指向 INapSystemHealthAgentCallback 接口的 COM 指针,NapAgent 用于通过通知/进程回调运行状况代理。 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 交换。 系统运行状况代理必须在使用 NapAgent 初始化后调用 NotifySoHChange 以请求 SoH 数据包的交换。

要求

要求
最低受支持的客户端
Windows Vista [仅限桌面应用]
最低受支持的服务器
Windows Server 2008 [仅限桌面应用]
标头
NapSystemHealthAgent.h
IDL
NapSystemHealthAgent.idl
DLL
Qagent.dll

另请参阅

INapSystemHealthAgentBinding