Interface IXMLHTTPRequest3 (msxml6.h)

  • Article

Fournit les méthodes et les propriétés nécessaires pour configurer et envoyer des requêtes HTTP et utiliser des rappels pour recevoir des notifications pendant le traitement de la réponse HTTP. Dérive de l’interface IXMLHTTPRequest2 .

Note Cette interface est prise en charge sur Windows Phone 8.1.

 

Héritage

L’interface IXMLHTTPRequest3 hérite de IXMLHTTPRequest2. IXMLHTTPRequest3 a également les types de membres suivants :

Méthodes

L’interface IXMLHTTPRequest3 comporte ces méthodes.

 
IXMLHTTPRequest3 ::SetClientCertificate

Définit un certificat client à utiliser pour l’authentification auprès de l’URL spécifiée dans la méthode Open.

Remarques

L’interface IXMLHTTPRequest3 configure et envoie des requêtes HTTP et utilise des rappels pour recevoir des notifications pendant le traitement de la réponse HTTP. L’interface IXMLHTTPRequest3 permet aux applications de s’exécuter dans un appartement multithread (MTA), une condition requise pour s’exécuter sous le Windows Runtime (WinRT).

L’interface IXMLHTTPRequest3 étend l’interface IXMLHTTPRequest2.

Les interfaces IXMLHTTPRequest3 et IXMLHTTPRequest3Callback étendent les fonctionnalités fournies par les interfaces IXMLHTTPRequest2 et IXMLHTTPRequest2Callback avec ces ajouts :

  • Permet de définir un certificat client à utiliser pour la requête HTTPS avec la méthode SetClientCertificate sur l’interface IXMLHTTPRequest3 .
  • Permet d’obtenir une liste d’émetteurs pour vous aider à filtrer les certificats clients éligibles à utiliser pour la prochaine requête HTTP avec la méthode OnClientCertificateRequested sur l’interface IXMLHTTPRequest3Callback .
  • Permet d’ignorer certaines erreurs de certificat qui auraient sinon abandonné la connexion HTTPS.
  • Permet d’obtenir des erreurs de certificat et la chaîne de certificats de serveur à partir de la réponse HTTPS avec la méthode OnServerCertificateReceived sur l’interface IXMLHTTPRequest3Callback .

La méthode SetProperty sur l’interface IXMLHTTPRequest2 est étendue sur l’interface IXMLHTTPRequest3 avec de nouvelles propriétés pour prendre en charge de nouveaux scénarios :

  • XHR_PROP_NO_CACHE : supprime les lectures et écritures du cache pour la requête HTTP.
  • XHR_PROP_EXTENDED_ERROR : provoque la pile HTTP pour fournir à HRESULTS le code d’erreur Win32 sous-jacent à la méthode OnError en cas de défaillance.
  • XHR_PROP_QUERY_STRING_UTF8 : entraîne l’encodage de la chaîne de requête en UTF-8 au lieu de la requête ACP pour HTTP.
  • XHR_PROP_IGNORE_CERT_ERRORS : supprime certaines erreurs de certificat de serveur.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 8.1 [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2012 R2 [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête msxml6.h

Voir aussi

IXMLHTTPRequest2

IXMLHTTPRequest2Callback

IXMLHTTPRequest3Callback

setProperty