XNetworkingVerifyServerCertificate
追加の証明書チェーン検証を提供します。構文
パラメーター
requestHandle _In_Type: void* HINTERNET 型のハンドル。有効なハンドルを取得するには、WinHttpOpenRequest を呼び出します。 securityInformation _In_
Type: XNetworkingSecurityInformation*
XNetworkingSecurityInformation 構造体へのポインター。適切なポインターを取得するには、XNetworkingQuerySecurityInformationForUrlAsyncResult 関数を呼び出します。
戻り値
Type: 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