XNetworkingVerifyServerCertificate
提供額外的憑證鏈結驗證。語法
參數
requestHandle _In_類型:void* 類型為 HINTERNET 的控制代碼。若要取得有效的控制代碼,請呼叫 WinHttpOpenRequest。 securityInformation _In_
類型:XNetworkingSecurityInformation* 指向
XNetworkingSecurityInformation 結構的指標。若要取得適當的指標,請呼叫 XNetworkingQuerySecurityInformationForUrlAsyncResult 函式。
傳回值
類型:HRESULT 如果成功,則傳回S_OK。這表示伺服器憑證鏈結有效。否則會傳回錯誤碼,指出無法驗證伺服器鏈結。請將所有失敗視為 HTTP 要求的嚴重錯誤。
備註
在時間敏感執行緒上呼叫此函式並不安全。如需詳細資訊,請參閱時間敏感執行緒。
WINHTTP_CALLBACK_STATUS_SENDING_REQUEST WinHTTP 回呼內呼叫此函式。傳遞先前呼叫 XNetworkingQuerySecurityInformationForUrlAsync 所快取的 XNetworkingSecurityInformation 結構,以及與該回呼相關聯的 WinHTTP 要求控制代碼。如需回呼的其他資訊,請參閱 WinHttpSendRequest。
如果 XNetworkingVerifyServerCertificate 函式失敗,表示遊戲執行階段可能偵測到與伺服器的連線已遭入侵。在此情況下,您應該在回呼傳回之前立即關閉 WinHTTP 要求控制代碼,以確保不會有任何資料傳輸到遭入侵的伺服器或從該伺服器傳輸過來。
最佳做法是,無論內容或通訊協定為何,所有遊戲的通訊都應受到保護。遊戲應為所有遊戲通訊提供機密性、完整性和驗證。如需詳細資訊,請參閱通訊安全性概觀 (NDA 主題)
需求
標頭: XNetworking.h 程式庫: xgameruntime.lib 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機概念文件
另請參閱
HTTP 和 WebSocketXNetworking
