Interfaccia IXMLHTTPRequest3 (msxml6.h)

Fornisce i metodi e le proprietà necessari per configurare e inviare richieste HTTP e usare callback per ricevere notifiche durante l'elaborazione della risposta HTTP. Deriva dall'interfaccia IXMLHTTPRequest2 .

Nota Questa interfaccia è supportata in Windows Phone 8.1.

 

Ereditarietà

L'interfaccia IXMLHTTPRequest3 eredita da IXMLHTTPRequest2. IXMLHTTPRequest3 include anche questi tipi di membri:

Metodi

L'interfaccia IXMLHTTPRequest3 include questi metodi.

 
IXMLHTTPRequest3::SetClientCertificate

Imposta un certificato client da usare per l'autenticazione con l'URL specificato nel metodo Open.

Commenti

L'interfaccia IXMLHTTPRequest3 configura e invia richieste HTTP e usa callback per ricevere notifiche durante l'elaborazione della risposta HTTP. L'interfaccia IXMLHTTPRequest3 consente alle app di eseguire in un appartamento multi-thread (MTA), un requisito per l'esecuzione nella Windows Runtime (WinRT).

L'interfaccia IXMLHTTPRequest3 estende l'interfaccia IXMLHTTPRequest2 .

Le interfacce IXMLHTTPRequest3 e IXMLHTTPRequest3Callback estendono le funzionalità fornite dalle interfacce IXMLHTTPRequest2 e IXMLHTTPRequest2Callback con queste aggiunte:

  • Consente di impostare un certificato client da usare per la richiesta HTTPS con il metodo SetClientCertificate nell'interfaccia IXMLHTTPRequest3 .
  • Consente di ottenere un elenco di autorità emittente per filtrare i certificati client idonei da usare per la richiesta HTTP successiva con il metodo OnClientCertificateRequested nell'interfaccia IXMLHTTPRequest3Callback .
  • Consente di ignorare determinati errori del certificato che altrimenti avrebbero interrotto la connessione HTTPS.
  • Consente di ottenere errori del certificato e della catena di certificati del server dalla risposta HTTPS con il metodo OnServerCertificateReceived nell'interfaccia IXMLHTTPRequest3Callback .

Il metodo SetProperty nell'interfaccia IXMLHTTPRequest2 viene esteso nell'interfaccia IXMLHTTPRequest3 con nuove proprietà per supportare nuovi scenari:

  • XHR_PROP_NO_CACHE: elimina le letture e le scritture della cache per la richiesta HTTP.
  • XHR_PROP_EXTENDED_ERROR: causa l'errore dello stack HTTP per fornire HRESULTS con il codice di errore Win32 sottostante al metodo OnError in caso di errore.
  • XHR_PROP_QUERY_STRING_UTF8 : causa la codifica della stringa di query in UTF-8 anziché ACP per la richiesta HTTP.
  • XHR_PROP_IGNORE_CERT_ERRORS: elimina determinati errori del certificato server.

Requisiti

Requisito Valore
Client minimo supportato Windows 8.1 [app desktop | App UWP]
Server minimo supportato Windows Server 2012 R2 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione msxml6.h

Vedi anche

IXMLHTTPRequest2

IXMLHTTPRequest2Callback

IXMLHTTPRequest3Callback

SetProperty