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

# XNetworkingVerifyServerCertificate

> XNetworkingVerifyServerCertificate

# XNetworkingVerifyServerCertificate

提供額外的憑證鏈結驗證。

## 語法

```cpp theme={null}
HRESULT XNetworkingVerifyServerCertificate(
         void* requestHandle,
         const XNetworkingSecurityInformation* securityInformation
)
```

### 參數

*requestHandle*   \_In\_\
類型：void\*

類型為 [HINTERNET](https://learn.microsoft.com/windows/win32/winhttp/hinternet-handles-in-winhttp) 的控制代碼。若要取得有效的控制代碼，請呼叫 [WinHttpOpenRequest](https://learn.microsoft.com/windows/win32/api/winhttp/nf-winhttp-winhttpopenrequest)。

*securityInformation*   \_In\_\
類型：[XNetworkingSecurityInformation](/zh-TW/reference/networking/xnetworking/structs/xnetworkingsecurityinformation)\*

指向 `XNetworkingSecurityInformation` 結構的指標。若要取得適當的指標，請呼叫 [XNetworkingQuerySecurityInformationForUrlAsyncResult](/zh-TW/reference/networking/xnetworking/functions/xnetworkingquerysecurityinformationforurlasyncresult) 函式。

### 傳回值

類型：HRESULT

如果成功，則傳回 `S_OK`。這表示伺服器憑證鏈結有效。否則會傳回錯誤碼，指出無法驗證伺服器鏈結。請將所有失敗視為 HTTP 要求的嚴重錯誤。

## 備註

<Note>在時間敏感執行緒上呼叫此函式並不安全。如需詳細資訊，請參閱[時間敏感執行緒](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)。</Note>

請從 `WINHTTP_CALLBACK_STATUS_SENDING_REQUEST` WinHTTP 回呼內呼叫此函式。傳遞先前呼叫 [XNetworkingQuerySecurityInformationForUrlAsync](/zh-TW/reference/networking/xnetworking/functions/xnetworkingquerysecurityinformationforurlasync) 所快取的 `XNetworkingSecurityInformation` 結構，以及與該回呼相關聯的 WinHTTP 要求控制代碼。如需回呼的其他資訊，請參閱 [WinHttpSendRequest](https://learn.microsoft.com/windows/win32/api/winhttp/nf-winhttp-winhttpsendrequest)。

如果 `XNetworkingVerifyServerCertificate` 函式失敗，表示遊戲執行階段可能偵測到與伺服器的連線已遭入侵。在此情況下，您應該在回呼傳回之前立即關閉 WinHTTP 要求控制代碼，以確保不會有任何資料傳輸到遭入侵的伺服器或從該伺服器傳輸過來。

最佳做法是，無論內容或通訊協定為何，所有遊戲的通訊都應受到保護。遊戲應為所有遊戲通訊提供機密性、完整性和驗證。如需詳細資訊，請參閱[通訊安全性概觀 (NDA 主題)](/zh-TW/build/game-principles/security/communication-security-overview)

## 需求

**標頭：** XNetworking.h

**程式庫：** xgameruntime.lib

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

## 概念文件

* [WinHTTP 概觀](/zh-TW/build/console-features/networking/web-requests/intro-winhttp)
* [時間敏感執行緒](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## 另請參閱

[HTTP 和 WebSocket](/zh-TW/build/console-features/networking/web-requests/http-networking)\
[XNetworking](/zh-TW/reference/networking/xnetworking/xnetworking_members)


## Related topics

- [WinHTTP 概觀](/zh-TW/build/console-features/networking/web-requests/intro-winhttp.md)
- [XNetworking](/zh-TW/reference/networking/xnetworking/xnetworking_members.md)
- [Upload Certificate](/api-reference/multiplayerserver/upload-certificate.md)
- [Delete Certificate](/api-reference/multiplayerserver/delete-certificate.md)
- [certificate_uploaded](/zh-TW/services/playfab/api-references/events/MultiplayerServers/certificate-uploaded.md)