Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

IXMLHTTPRequest3 interface

Provides the methods and properties needed to configure and send HTTP requests and use callbacks to receive notifications during HTTP response processing. Derives from the IXMLHTTPRequest2 interface.

Note  This interface is supported on Windows Phone 8.1.

Members

The IXMLHTTPRequest3 interface inherits from IXMLHTTPRequest2. IXMLHTTPRequest3 also has these types of members:

Methods

The IXMLHTTPRequest3 interface has these methods.

MethodDescription
IXMLHTTPRequest3::SetClientCertificate

Sets a client certificate to be used to authenticate against the URL specified in the Open method.

 

Remarks

The IXMLHTTPRequest3 interface configures and sends HTTP requests and uses callbacks to receive notifications during HTTP response processing. The IXMLHTTPRequest3 interface allows apps to run in a multi-threaded apartment (MTA), a requirement for running under the Windows Runtime (WinRT).

The IXMLHTTPRequest3 interface extends the IXMLHTTPRequest2 interface.

The IXMLHTTPRequest3 and IXMLHTTPRequest3Callback interfaces extend the features provided by the IXMLHTTPRequest2 and IXMLHTTPRequest2Callback interfaces with these additions:

  • Allows setting a client certificate to use for the HTTPS request with the SetClientCertificate method on the IXMLHTTPRequest3 interface.
  • Allows getting an issuer list to help filter down eligible client certificates to use for the next HTTP request with the OnClientCertificateRequested method on the IXMLHTTPRequest3Callback interface.
  • Allows ignoring certain certificate errors which would have otherwise aborted the HTTPS connection.
  • Allows getting certificate errors and the server certificate chain from the HTTPS response with the OnServerCertificateReceived method on the IXMLHTTPRequest3Callback interface.

The SetProperty method on the IXMLHTTPRequest2 interface is extended on the IXMLHTTPRequest3 interface with new properties to support new scenarios:

  • XHR_PROP_NO_CACHE – Suppresses cache reads and writes for the HTTP request.
  • XHR_PROP_EXTENDED_ERROR – Causes the HTTP stack to provide HRESULTS with the underlying Win32 error code to the OnError method in case of failure.
  • XHR_PROP_QUERY_STRING_UTF8 – Causes the query string to be encoded in UTF-8 instead of ACP for HTTP request.
  • XHR_PROP_IGNORE_CERT_ERRORS – Suppresses certain server certificate errors.

Requirements

Minimum supported client

Windows 8.1 [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2012 R2 [desktop apps | Windows Store apps]

Minimum supported phone

Windows Phone 8.1 [Windows Phone Silverlight 8.1 and Windows Runtime apps]

IDL

Msxml6.idl

See also

IXMLHTTPRequest2
IXMLHTTPRequest2Callback
IXMLHTTPRequest3Callback
SetProperty

 

 

Community Additions

Show:
© 2014 Microsoft