> ## 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.

# XNetworkingQuerySecurityInformationForUrlUtf16Async

> XNetworkingQuerySecurityInformationForUrlUtf16Async

# XNetworkingQuerySecurityInformationForUrlUtf16Async

擷取與已在 Universal Developer Portal 中為啟用 XBOX Live 之遊戲設定的 URL 相關聯的安全性資訊。

## 語法

```cpp theme={null}
HRESULT XNetworkingQuerySecurityInformationForUrlUtf16Async(
         const wchar_t* url,
         XAsyncBlock* asyncBlock
)
```

### 參數

*url*   \_In\_z\_\
類型：wchar\_t\*

擷取憑證指紋清單的 URL 端點。

*asyncBlock*   \_Inout\_\
類型：[XAsyncBlock](/zh-TW/reference/system/xasync/structs/xasyncblock)\*

傳遞給 [XAsyncRun](/zh-TW/reference/system/xasync/functions/xasyncrun) 函式之 [XAsyncBlock](/zh-TW/reference/system/xasync/structs/xasyncblock) 結構的指標。

### 傳回值

類型：HRESULT

非同步呼叫的 HRESULT 成功或錯誤碼。

## 備註

此函式會針對透過 Universal Developer Portal 為遊戲設定之 URL 相關聯的憑證，啟動非同步要求。這可讓啟用 XBOX Live 的 Microsoft Game Development Kit (GDK) 遊戲在搭配 [Windows HTTP 服務 (WinHTTP)](https://learn.microsoft.com/windows/desktop/winhttp/winhttp-start-page) API 時，針對自訂的遊戲專屬服務端點執行憑證釘選。

<Note>對 XBOX Live 服務端點提出自訂 Web 要求時，請讓 XBOX Services API (XSAPI) 程式庫自動執行憑證釘選。</Note>

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

## 需求

**標頭：** XNetworking.h

**程式庫：** xgameruntime.lib

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

## 概念文件

* [WinHTTP 概觀](/zh-TW/build/console-features/networking/web-requests/intro-winhttp)

## 另請參閱

[擷取網路資訊](/zh-TW/build/console-features/networking/initialization-connectivity-networking)\
[XNetworkingQuerySecurityInformationForUrlUtf16AsyncResult](/zh-TW/reference/networking/xnetworking/functions/xnetworkingquerysecurityinformationforurlutf16asyncresult)\
[XNetworking](/zh-TW/reference/networking/xnetworking/xnetworking_members)


## Related topics

- [XNetworkingQuerySecurityInformationForUrlUtf16Async](/reference/networking/xnetworking/functions/xnetworkingquerysecurityinformationforurlutf16async.md)
- [XNetworkingQuerySecurityInformationForUrlUtf16AsyncResult](/reference/networking/xnetworking/functions/xnetworkingquerysecurityinformationforurlutf16asyncresult.md)