Skip to main content

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 和 WebSocket
XNetworking
最后修改于 2026年8月24日