XNetworkingVerifyServerCertificate
Fournit une validation supplémentaire de la chaîne de certificats.Syntaxe
Paramètres
requestHandle _In_Type : void* 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 renvoyée
Type : HRESULT RenvoieS_OK en cas de réussite. Cela indique que la chaîne de certificats du serveur est valide. Sinon, renvoie 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 sans risque sur un thread à durée critique. Pour plus d’informations, consultez Threads à durée critique.
WINHTTP_CALLBACK_STATUS_SENDING_REQUEST. Passez une structure XNetworkingSecurityInformation mise en cache lors 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 fermer immédiatement 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.
Il est recommandé de sécuriser toutes les communications du titre, quels que soient leur contenu ou leur protocole. 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