XNetworkingQuerySecurityInformationForUrlAsyncResult

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