Skip to content

Latest commit

 

History

History
101 lines (74 loc) · 5.31 KB

nn-msxml6-ixmlhttprequest3.md

File metadata and controls

101 lines (74 loc) · 5.31 KB
Raw
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NN:msxml6.IXMLHTTPRequest3
IXMLHTTPRequest3 (msxml6.h)
Provides the methods and properties needed to configure and send HTTP requests and use callbacks to receive notifications during HTTP response processing.
IXMLHTTPRequest3
IXMLHTTPRequest3 interface [XMLHttpRequest2]
IXMLHTTPRequest3 interface [XMLHttpRequest2]
described
ixhr2.ixmlhttprequest3
msxml6/IXMLHTTPRequest3
ixhr2\ixmlhttprequest3.htm
ixhr2
66af3f84-585c-441e-b9be-4ec188d72a19
12/05/2018
IXMLHTTPRequest3, IXMLHTTPRequest3 interface [XMLHttpRequest2], IXMLHTTPRequest3 interface [XMLHttpRequest2],described, ixhr2.ixmlhttprequest3, msxml6/IXMLHTTPRequest3
msxml6.h
Windows
Windows 8.1 [desktop apps \| UWP apps]
Windows Server 2012 R2 [desktop apps \| UWP apps]
Msxml6.idl
Windows
19H1
IXMLHTTPRequest3
msxml6/IXMLHTTPRequest3
c++
APIRef
kbSyntax
COM
msxml6.h
IXMLHTTPRequest3

IXMLHTTPRequest3 interface

-description

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.

 

-inheritance

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

-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.

-see-also

IXMLHTTPRequest2

IXMLHTTPRequest2Callback

IXMLHTTPRequest3Callback

SetProperty