INapSystemHealthValidationRequest：：GetSoHRequest 方法
注意
网络访问保护平台从Windows 10开始不可用
INapSystemHealthValidationRequest：：GetSoHRequest 方法允许系统运行状况验证程序 (SHV) 检索和验证其系统运行状况代理 (SHA) 客户端上的对应项发送的 SoHRequest 信息。
语法
HRESULT GetSoHRequest(
[out] SoHRequest **sohRequest,
[out] BOOL *napSystemGenerated
);
参数
-
sohRequest [out]
-
指向 SoHRequest 结构的指针的指针。
-
napSystemGenerated [out]
-
如果 SoH 由 NapAgent 代表 SHA 创建，则为 TRUE 的 BOOL，否则为 FALSE。 它主要用于指示 SHV 的 SHA 失败。
返回值
也可能返回其他特定于 COM 的错误代码。
| 返回代码 | 说明 |
|---|---|
|
操作成功。 |
|
权限错误，拒绝访问。 |
|
系统资源限制，无法执行该操作。 |
备注
如果客户端未将 SoHRequest 发送到 SHV，sohRequest 参数可能会返回 NULL。 在这种情况下，SHV 可以使用错误代码NAP_E_MISSING_SOH填充 SoHResponse。
如果 napSystemGenerated 参数为 TRUE， 则 SoHRequest 的格式如下所示：
- sohAttributeTypeSystemHealthId= <id>
- sohAttributeTypeFailureCategory= failureCategoryClientComponent
- sohAttributeTypeErrorCodes = <sha-failure-error-code>
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 |
无受支持的版本 |
| 最低受支持的服务器 |
Windows Server 2008 [仅限桌面应用] |
| 标头 |
|
| IDL |
|
| DLL |
|