XNetworkingQuerySecurityInformationForUrlUtf16AsyncResult

XNetworkingQuerySecurityInformationForUrlUtf16Async 函数获取缓冲区结果。

语法

HRESULT XNetworkingQuerySecurityInformationForUrlUtf16AsyncResult(
         XAsyncBlock* asyncBlock,
         size_t securityInformationBufferByteCount,
         size_t* securityInformationBufferByteCountUsed,
         uint8_t* securityInformationBuffer,
         XNetworkingSecurityInformation** securityInformation
)

参数

asyncBlock _Inout_
类型:XAsyncBlock*

指向传递到 XNetworkingQuerySecurityInformationForUrlUtf16Async 函数的 XAsyncBlock 结构的指针。

securityInformationBufferByteCount _In_
类型:size_t

要为结果缓冲区分配的大小(以字节为单位)。 此数据是通过调用 XNetworkingQuerySecurityInformationForUrlUtf16AsyncResultSize 函数获取的。 或者,如果你已预分配了一个较大的结果缓冲区,则可以传入预分配缓冲区的大小。

securityInformationBufferByteCountUsed _Out_opt_
类型:size_t*

指向实际结果缓冲区的大小的指针(以字节为单位)。

securityInformationBuffer _Out_writes_bytes_to_(securityInformationBufferByteCount,*securityInformationBufferByteCountUsed)
类型:uint8_t*

指向包含指纹结果的缓冲区的指针。

securityInformation _Outptr_
类型:XNetworkingSecurityInformation**

指向从网络安全允许列表 (NSAL) 返回的证书指纹列表的指针。

返回值

类型:HRESULT

HRESULT 成功或错误代码。

备注

此函数通过调用 XNetworkingQuerySecurityInformationForUrlUtf16Async 函数获取缓冲区结果。 分配给结果缓冲区的字节数是使用 securityInformationBufferByteCount 指针确定的。 结果缓冲区的实际字节数是使用 securityInformationBufferByteCountUsed 指针确定的。 指纹结果和 NSAL 返回的证书指纹列表是由 securityInformationBuffer 指针和 securityInformation 指针确定的。 有关 Microsoft 游戏开发工具包 (GDK) 游戏中的网络信息,请参阅检索网络信息

该方法在调用进程内查询本地状态并快速返回,因此从时间敏感的上下文中调用它是安全的。

要求

头文件:XNetworking.h

库:xgameruntime.lib

支持平台:Windows、Xbox One 系列主机和 Xbox Series 主机

另请参阅

HTTP 和 Web 套接字
XNetworkingQuerySecurityInformationForUrlAsyncResult
XNetworking