> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XNetworkingQuerySecurityInformationForUrlAsyncResult

> XNetworkingQuerySecurityInformationForUrlAsyncResult

# XNetworkingQuerySecurityInformationForUrlAsyncResult

获取 [XNetworkingQuerySecurityInformationForUrlAsync](/reference/networking/xnetworking/functions/xnetworkingquerysecurityinformationforurlasync) 函数的结果。

## 语法

```cpp theme={null}
HRESULT XNetworkingQuerySecurityInformationForUrlAsyncResult(
         XAsyncBlock* asyncBlock,
         size_t securityInformationBufferByteCount,
         size_t* securityInformationBufferByteCountUsed,
         uint8_t* securityInformationBuffer,
         XNetworkingSecurityInformation** securityInformation
)
```

### 参数

*asyncBlock*   \_Inout\_\
类型：[XAsyncBlock](/reference/system/xasync/structs/xasyncblock)\*

指向已传递给 [XNetworkingQuerySecurityInformationForUrlAsync](/reference/networking/xnetworking/functions/xnetworkingquerysecurityinformationforurlasync) 函数的 [XAsyncBlock](/reference/system/xasync/structs/xasyncblock) 的指针。

*securityInformationBufferByteCount*   \_In\_\
类型：size\_t

为结果缓冲区分配的大小（以字节为单位）。此数据通过调用 [XNetworkingQuerySecurityInformationForUrlAsyncResultSize](/reference/networking/xnetworking/functions/xnetworkingquerysecurityinformationforurlasyncresultsize) 获取。或者，如果你已预分配一个大的结果缓冲区，则可以传入预分配缓冲区的大小。

*securityInformationBufferByteCountUsed*   \_Out\_opt\_\
类型：size\_t\*

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

*securityInformationBuffer*   \_Out\_writes\_bytes\_to\_(securityInformationBufferByteCount,\*securityInformationBufferByteCountUsed)\
类型：uint8\_t\*

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

*securityInformation*   \_Outptr\_\
类型：[XNetworkingSecurityInformation](/reference/networking/xnetworking/structs/xnetworkingsecurityinformation)\*\*

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

### 返回值

类型：HRESULT

HRESULT 成功或错误代码。

## 备注

此函数用于获取 [XNetworkingQuerySecurityInformationForUrlAsync](/reference/networking/xnetworking/functions/xnetworkingquerysecurityinformationforurlasync) 函数的结果。其指针分别指示为结果缓冲区分配的字节大小、实际使用的缓冲区字节大小、包含指纹结果的缓冲区，以及从 NSAL 返回的证书指纹列表。

该缓冲区是安全信息结构指针中所有指针使用的底层缓冲区。只要仍在使用安全信息结构指针，游戏就应保持该缓冲区的有效性。释放并清理该缓冲区也会清理安全信息结构指针使用的所有内存。有关 Microsoft 游戏开发工具包 (GDK) 游戏中的网络信息，请参阅[检索网络信息](/build/console-features/networking/initialization-connectivity-networking)。

此方法查询调用进程中的本地状态并快速返回，因此可以从时间敏感的上下文中安全调用。

## 要求

**头文件：** XNetworking.h

**库：** xgameruntime.lib

**支持的平台：** Windows、XBOX One 系列主机和 XBOX Series 主机

## 另请参阅

[HTTP 和 Web 套接字](/build/console-features/networking/web-requests/http-networking)\
[XNetworkingQuerySecurityInformationForUrlUtf16AsyncResult](/reference/networking/xnetworking/functions/xnetworkingquerysecurityinformationforurlutf16asyncresult)\
[XNetworking](/reference/networking/xnetworking/xnetworking_members)


## Related topics

- [XNetworkingQuerySecurityInformationForUrlUtf16AsyncResult](/zh-CN/reference/networking/xnetworking/functions/xnetworkingquerysecurityinformationforurlutf16asyncresult.md)
- [XNetworkingVerifyServerCertificate](/zh-CN/reference/networking/xnetworking/functions/xnetworkingverifyservercertificate.md)
- [XNetworking](/zh-CN/reference/networking/xnetworking/xnetworking_members.md)
- [面向 GDK 的 Unity C# API 包装器](/zh-CN/build/gdk-and-engines/unity/unity-api-wrappers.md)
- [XNetworkingQuerySecurityInformationForUrlAsyncResultSize](/zh-CN/reference/networking/xnetworking/functions/xnetworkingquerysecurityinformationforurlasyncresultsize.md)