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

# XNetworkingQuerySecurityInformationForUrlUtf16AsyncResult

> XNetworkingQuerySecurityInformationForUrlUtf16AsyncResult

# XNetworkingQuerySecurityInformationForUrlUtf16AsyncResult

取得 [XNetworkingQuerySecurityInformationForUrlUtf16Async](https://docs.xbox.com/zh-TW/reference/networking/xnetworking/functions/xnetworkingquerysecurityinformationforurlutf16async.md) 函式的緩衝區結果。

## 語法

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

### 參數

*asyncBlock*   \_Inout\_\
類型：[XAsyncBlock](https://docs.xbox.com/zh-TW/reference/system/xasync/structs/xasyncblock.md)\*

傳遞給 [XNetworkingQuerySecurityInformationForUrlUtf16Async](https://docs.xbox.com/zh-TW/reference/networking/xnetworking/functions/xnetworkingquerysecurityinformationforurlutf16async.md) 函式之 [XAsyncBlock](https://docs.xbox.com/zh-TW/reference/system/xasync/structs/xasyncblock.md) 結構的指標。

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

要為結果緩衝區配置的大小 (以位元組為單位)。此資料可藉由呼叫 [XNetworkingQuerySecurityInformationForUrlUtf16AsyncResultSize](https://docs.xbox.com/zh-TW/reference/networking/xnetworking/functions/xnetworkingquerysecurityinformationforurlutf16asyncresultsize.md) 函式取得。或者，如果您已預先配置大型結果緩衝區，可以傳入預先配置之緩衝區的大小。

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

實際結果緩衝區大小 (以位元組為單位) 的指標。

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

包含指紋結果之緩衝區的指標。

*securityInformation*   \_Outptr\_\
類型：[XNetworkingSecurityInformation](https://docs.xbox.com/zh-TW/reference/networking/xnetworking/structs/xnetworkingsecurityinformation.md)\*\*

從網路安全性允許清單 (NSAL) 傳回之憑證指紋清單的指標。

### 傳回值

類型：HRESULT

HRESULT 成功或錯誤碼。

## 備註

此函式會藉由呼叫 `XNetworkingQuerySecurityInformationForUrlUtf16Async` 函式來取得緩衝區結果。配置給結果緩衝區的位元組數是使用 *securityInformationBufferByteCount* 指標來決定。結果緩衝區的實際位元組數是使用 *securityInformationBufferByteCountUsed* 指標來決定。指紋結果和從 NSAL 傳回的憑證指紋清單是由 *securityInformationBuffer* 指標和 *securityInformation* 指標來決定。如需 Microsoft Game Development Kit (GDK) 遊戲中的網路資訊，請參閱[擷取網路資訊](https://docs.xbox.com/zh-TW/build/console-features/networking/initialization-connectivity-networking.md)。

此方法會查詢呼叫處理程序內的本機狀態並快速傳回，因此可以安全地從時間敏感的內容中呼叫。

## 需求

**標頭：** XNetworking.h

**程式庫：** xgameruntime.lib

**支援的平台：** Windows、XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

[HTTP 和 WebSocket](https://docs.xbox.com/zh-TW/build/console-features/networking/web-requests/http-networking.md)\
[XNetworkingQuerySecurityInformationForUrlAsyncResult](https://docs.xbox.com/zh-TW/reference/networking/xnetworking/functions/xnetworkingquerysecurityinformationforurlasyncresult.md)\
[XNetworking](https://docs.xbox.com/zh-TW/reference/networking/xnetworking/xnetworking_members.md)


## Related topics

- [XNetworkingQuerySecurityInformationForUrlUtf16Async](https://docs.xbox.com/zh-TW/reference/networking/xnetworking/functions/xnetworkingquerysecurityinformationforurlutf16async.md)
- [XNetworkingQuerySecurityInformationForUrlAsyncResult](https://docs.xbox.com/zh-TW/reference/networking/xnetworking/functions/xnetworkingquerysecurityinformationforurlasyncresult.md)
- [XNetworking (API 內容)](https://docs.xbox.com/zh-TW/reference/networking/xnetworking/xnetworking_members.md)
- [在 Unity 專案中使用 GDK API 的 C# 包裝函式](https://docs.xbox.com/zh-TW/build/gdk-and-engines/unity/unity-api-wrappers.md)
- [XNetworkingQuerySecurityInformationForUrlUtf16AsyncResultSize](https://docs.xbox.com/zh-TW/reference/networking/xnetworking/functions/xnetworkingquerysecurityinformationforurlutf16asyncresultsize.md)