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

# XNetworkingQuerySecurityInformationForUrlAsync

> XNetworkingQuerySecurityInformationForUrlAsync

# XNetworkingQuerySecurityInformationForUrlAsync

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

## 語法

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

### 參數

*url*   \_In\_z\_\
類型：char\*

安全性資訊和憑證指紋清單的 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 時，針對自訂的遊戲專屬服務端點執行憑證釘選。對 XBOX Live 服務端點提出任何自訂 Web 要求時也需要此功能。XBOX Services API (XSAPI) 程式庫會自動處理此需求。

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

## 需求

**標頭：** XNetworking.h

**程式庫：** xgameruntime.lib

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

## 另請參閱

[擷取網路資訊](/zh-TW/build/console-features/networking/initialization-connectivity-networking)\
[HTTP 和 WebSocket](/zh-TW/build/console-features/networking/web-requests/http-networking)\
[XNetworking](/zh-TW/reference/networking/xnetworking/xnetworking_members)


## Related topics

- [XNetworkingQuerySecurityInformationForUrlAsync](/zh-CN/reference/networking/xnetworking/functions/xnetworkingquerysecurityinformationforurlasync.md)
- [XNetworkingQuerySecurityInformationForUrlAsyncResult](/reference/networking/xnetworking/functions/xnetworkingquerysecurityinformationforurlasyncresult.md)
- [XNetworkingQuerySecurityInformationForUrlAsyncResultSize](/reference/networking/xnetworking/functions/xnetworkingquerysecurityinformationforurlasyncresultsize.md)
- [XNetworkingSecurityInformation](/zh-CN/reference/networking/xnetworking/structs/xnetworkingsecurityinformation.md)