XNetworkingVerifyServerCertificate
Fournit une validation supplémentaire de la chaîne de certificats.Syntaxe
Paramètres
requestHandle _In_Type : void* Un handle de type HINTERNET. Pour obtenir un handle valide, appelez WinHttpOpenRequest. securityInformation _In_
Type : XNetworkingSecurityInformation* Pointeur vers une structure
XNetworkingSecurityInformation. Pour obtenir un pointeur approprié, appelez la fonction XNetworkingQuerySecurityInformationForUrlAsyncResult.
Valeur de retour
Type : HRESULT RetourneS_OK en cas de réussite. Cela indique que la chaîne de certificats du serveur est valide. Sinon, retourne un code d’erreur indiquant que la chaîne du serveur n’a pas pu être validée. Traitez tous les échecs comme fatals pour la requête HTTP.
Remarques
Cette fonction ne peut pas être appelée en toute sécurité sur un thread à délai critique. Pour plus d’informations, consultez Threads à délai critique.
WINHTTP_CALLBACK_STATUS_SENDING_REQUEST. Passez une structure XNetworkingSecurityInformation mise en cache provenant d’un appel précédent à XNetworkingQuerySecurityInformationForUrlAsync, ainsi que le handle de requête WinHTTP associé au rappel. Pour plus d’informations sur le rappel, consultez WinHttpSendRequest.
Si la fonction XNetworkingVerifyServerCertificate échoue, le runtime de jeu a probablement détecté une connexion compromise au serveur. Dans ce cas, vous devez immédiatement fermer le handle de requête WinHTTP avant le retour du rappel afin de garantir qu’aucune donnée n’est transférée vers ou depuis le serveur compromis.
Comme pratique exemplaire, toutes les communications du titre, quel que soit leur contenu ou leur protocole, doivent être sécurisées. Un titre doit assurer la confidentialité, l’intégrité et l’authentification de toutes ses communications. Pour plus d’informations, consultez Vue d’ensemble de la sécurité des communications (rubrique sous NDA)
Configuration requise
En-tête : XNetworking.h Bibliothèque : xgameruntime.lib Plateformes prises en charge : Windows, consoles de la famille XBOX One et consoles XBOX SeriesDocumentation conceptuelle
Voir aussi
HTTP et WebSocketsXNetworking