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 的错误代码。
返回代码 | 说明 |
---|---|
|
操作成功。 |
|
权限错误,拒绝访问。 |
|
系统资源限制,无法执行该操作。 |
|
如果 SHA 之前已初始化,则返回此错误。 |
|
如果之前尚未注册 SHA,则返回此错误。 |
|
NapAgent 已停止。 重启后,此对象将自动恢复并重新绑定到 NapAgent。 |
备注
NapAgent 不会由于初始化而触发 SoH 交换。 系统运行状况代理必须在使用 NapAgent 初始化后调用 NotifySoHChange 以请求 SoH 数据包的交换。
要求
要求 | 值 |
---|---|
最低受支持的客户端 |
Windows Vista [仅限桌面应用] |
最低受支持的服务器 |
Windows Server 2008 [仅限桌面应用] |
标头 |
|
IDL |
|
DLL |
|