从 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