Поделиться через

Интерфейс IXMLHTTPRequest3 (msxml6.h)

  • Статья

Предоставляет методы и свойства, необходимые для настройки и отправки HTTP-запросов и использования обратных вызовов для получения уведомлений во время обработки HTTP-ответа. Наследуется от интерфейса IXMLHTTPRequest2 .

Примечание Этот интерфейс поддерживается в Windows Phone 8.1.

 

Наследование

Интерфейс IXMLHTTPRequest3 наследуется от IXMLHTTPRequest2. IXMLHTTPRequest3 также имеет следующие типы элементов:

Методы

Интерфейс IXMLHTTPRequest3 содержит следующие методы.

 
IXMLHTTPRequest3::SetClientCertificate

Задает сертификат клиента, используемый для проверки подлинности по URL-адресу, указанному в методе Open.

Комментарии

Интерфейс IXMLHTTPRequest3 настраивает и отправляет HTTP-запросы и использует обратные вызовы для получения уведомлений во время обработки HTTP-ответа. Интерфейс IXMLHTTPRequest3 позволяет приложениям выполняться в многопоточных квартирах (MTA), что является обязательным требованием для работы в среда выполнения Windows (WinRT).

Интерфейс IXMLHTTPRequest3 расширяет интерфейс IXMLHTTPRequest2 .

Интерфейсы IXMLHTTPRequest3 и IXMLHTTPRequest3Callback расширяют возможности интерфейсов IXMLHTTPRequest2 и IXMLHTTPRequest2Callback следующими дополнениями:

  • Позволяет задать сертификат клиента, используемый для HTTPS-запроса с помощью метода SetClientCertificate в интерфейсе IXMLHTTPRequest3 .
  • Позволяет получить список издателей, чтобы отфильтровать подходящие сертификаты клиента для использования для следующего HTTP-запроса с помощью метода OnClientCertificateRequested в интерфейсе IXMLHTTPRequest3Callback .
  • Позволяет игнорировать определенные ошибки сертификата, которые в противном случае прервали бы HTTPS-подключение.
  • Позволяет получать ошибки сертификатов и цепочку сертификатов сервера из ответа HTTPS с помощью метода OnServerCertificateReceived в интерфейсе IXMLHTTPRequest3Callback .

Метод SetProperty в интерфейсе IXMLHTTPRequest2 расширен в интерфейсе IXMLHTTPRequest3 с новыми свойствами для поддержки новых сценариев:

  • XHR_PROP_NO_CACHE — подавляет операции чтения и записи кэша для HTTP-запроса.
  • XHR_PROP_EXTENDED_ERROR — приводит к тому, что стек HTTP предоставляет HRESULTS с базовым кодом ошибки Win32 методу OnError в случае сбоя.
  • XHR_PROP_QUERY_STRING_UTF8 — вызывает кодирование строки запроса в UTF-8 вместо ACP для HTTP-запроса.
  • XHR_PROP_IGNORE_CERT_ERRORS — подавляет определенные ошибки сертификата сервера.

Требования

Требование Значение
Минимальная версия клиента Windows 8.1 [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2012 R2 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header msxml6.h

См. также раздел

IXMLHTTPRequest2

IXMLHTTPRequest2Callback

IXMLHTTPRequest3Callback

SetProperty