INapSystemHealthAgentCallback::NotifyOrphanedSoHRequest 方法

注意

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

如果从 SHA 查询 SoHRequest,则调用 INapSystemHealthAgentCallback::NotifyOrphanedSoHRequest 方法,但响应从未返回。

语法

HRESULT NotifyOrphanedSoHRequest(
  [in] const CorrelationId *correlationId
);

parameters

correlationId [in]

指向标识孤立 SoHRequest 的唯一 CorrelationId 结构的指针。

返回值

此方法可以返回其中一个值。

返回代码 说明
S_OK
表示成功。

备注

此回调方法由 NAP 系统声明,并由 SHA 编写器实现。

在以下情况下,系统可以调用此方法:

  • 无法通过网络发送 SoHRequest
  • 在网络上发送了 SoHRequest ,但没有返回 SoHResponse ,即强制程序超时或服务器端没有相应的 SHV。
  • 连接中断或强制程序脱机。

这只是一个尽力而为的通知,因此 SHA 不得依赖此信息来清理状态。 在某些情况下,SHA 不会收到通知:

  • 如果强制程序有误,即当连接状态关闭时,它不会通知 SHA。
  • 如果强制程序崩溃。
  • 在错误情况下,即 NapAgent 内存不足。

SHA 在首次绑定到 NapAgent 时可能会收到一些虚假通知,例如,如果在 SHA 绑定时正在进行 SoH 交换,然后超时。

要求

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

请参阅

INapSystemHealthAgentCallback