XNetworkingVerifyServerCertificate
提供额外的证书链验证。语法
参数
requestHandle _In_类型:void* 类型为 HINTERNET 的句柄。若要获取有效句柄,请调用 WinHttpOpenRequest。 securityInformation _In_
类型:XNetworkingSecurityInformation* 指向
XNetworkingSecurityInformation 结构体的指针。若要获取合适的指针,请调用XNetworkingQuerySecurityInformationForUrlAsyncResult 函数。
返回值
类型:HRESULT 如果成功,则返回S_OK。这表示服务器证书链有效。否则,返回一个错误代码,表示无法验证服务器链。应将所有失败视为 HTTP 请求的致命错误。
备注
此函数不能在时间敏感的线程上安全调用。有关详细信息,请参阅时间敏感线程。
WINHTTP_CALLBACK_STATUS_SENDING_REQUEST WinHTTP 回调内部调用此函数。将之前调用 XNetworkingQuerySecurityInformationForUrlAsync 返回的、已缓存的 XNetworkingSecurityInformation 结构体连同与该回调关联的 WinHTTP 请求句柄一起传入。有关回调的更多信息,请参阅 WinHttpSendRequest。
如果 XNetworkingVerifyServerCertificate 函数失败,则游戏运行时很可能检测到与服务器的连接已被入侵。在这种情况下,你应在回调返回之前立即关闭 WinHTTP 请求句柄,以确保没有数据被传输到已被入侵的服务器或从中传出。
作为一种最佳做法,所有游戏通信,无论内容或协议如何,都应该是安全的。游戏应为其所有通信提供机密性、完整性和身份验证。有关详细信息,请参阅通信安全概述(NDA 主题)
要求
头文件: XNetworking.h 库: xgameruntime.lib 支持的平台: Windows、XBOX One 系列主机和 XBOX Series 主机概念文档
另请参阅
HTTP 和 WebSocketXNetworking
