从 XNetworkingQuerySecurityInformationForUrlAsync 函数获取结果。
语法
HRESULT XNetworkingQuerySecurityInformationForUrlAsyncResult(
XAsyncBlock* asyncBlock,
size_t securityInformationBufferByteCount,
size_t* securityInformationBufferByteCountUsed,
uint8_t* securityInformationBuffer,
XNetworkingSecurityInformation** securityInformation
)
参数
asyncBlock _Inout_
类型:XAsyncBlock*
指向传递到 XNetworkingQuerySecurityInformationForUrlAsync 函数的 XAsyncBlock 的指针。
securityInformationBufferByteCount _In_
类型:size_t
要为结果缓冲区分配的大小(以字节为单位)。 此数据是通过调用 XNetworkingQuerySecurityInformationForUrlAsyncResultSize 获取的。 或者,如果你已预分配了一个较大的结果缓冲区,则可以传入预分配缓冲区的大小。
securityInformationBufferByteCountUsed _Out_opt_
类型:size_t*
指向实际结果缓冲区的大小的指针(以字节为单位)。
securityInformationBuffer _Out_writes_bytes_to_(securityInformationBufferByteCount,*securityInformationBufferByteCountUsed)
类型:uint8_t*
指向包含指纹结果的缓冲区的指针。
securityInformation _Outptr_
类型:XNetworkingSecurityInformation**
指向从网络安全允许列表 (NSAL) 返回的证书指纹列表的指针。
返回值
类型:HRESULT
HRESULT 成功或错误代码。
备注
此函数从 XNetworkingQuerySecurityInformationForUrlAsync 函数获取结果。 其指针确定分配给结果缓冲区的字节大小、缓冲区字节大小的实际结果、包含指纹结果的缓冲区,以及从 NSAL 返回的证书指纹列表。
此缓冲区是安全信息结构指针中所有指针使用的基础缓冲区。 游戏应该使缓冲区保持有效状态,只要它正在使用安全信息结构指针。 释放并清理缓冲区也会清理安全信息结构指针所使用的所有内存。 有关 Microsoft 游戏开发工具包 (GDK) 游戏中的网络信息,请参阅检索网络信息。
该方法在调用进程内查询本地状态并快速返回,因此从时间敏感的上下文中调用它是安全的。
要求
头文件:XNetworking.h
库:xgameruntime.lib
支持平台:Windows、Xbox One 系列主机和 Xbox Series 主机
另请参阅
HTTP 和 Web 套接字
XNetworkingQuerySecurityInformationForUrlUtf16AsyncResult
XNetworking