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

Метод IXMLHTTPRequest2::SetProperty (msxml6.h)

  • Статья

Задает свойство для исходящего HTTP-запроса.

Синтаксис

HRESULT SetProperty(
  [in] XHR_PROPERTY eProperty,
  [in] ULONGLONG    ullValue
);

Параметры

[in] eProperty

Допустимы следующие значения.

Значение Значение
XHR_PROP_NO_CRED_PROMPT
 Подавляет автоматические запросы учетных данных пользователя
XHR_PROP_NO_AUTH
 Подавляет проверку подлинности, выполняемую стеком HTTP от имени приложения.
XHR_PROP_TIMEOUT
 Задает для всех значений времени ожидания значение, заданное параметром ullValue, в миллисекундах.
XHR_PROP_NO_DEFAULT_HEADERS
 Подавляет добавление заголовков по умолчанию в HTTP-запрос.
XHR_PROP_REPORT_REDIRECT_STATUS
 Вызывает стек HTTP для вызова метода OnHeadersAvailable с промежуточным кодом состояния перенаправления. Метод OnHeadersAvailable будет снова вызван для дополнительных перенаправлений и конечного кода состояния назначения.
XHR_PROP_NO_CACHE
 Подавляет операции чтения и записи в кэше для HTTP-запроса.

Это свойство поддерживается интерфейсом IXMLHTTPRequest3 .
XHR_PROP_EXTENDED_ERROR
 Вызывает стек HTTP для предоставления HRESULTS базового кода ошибки Win32 методу OnError в случае сбоя.

Это свойство поддерживается интерфейсом IXMLHTTPRequest3 .
XHR_PROP_QUERY_STRING_UTF8
Вызывает кодирование строки запроса в UTF-8 вместо ACP для HTTP-запроса.

Это свойство поддерживается интерфейсом IXMLHTTPRequest3 .
XHR_PROP_IGNORE_CERT_ERRORS
 Подавляет определенные ошибки сертификата.

Это свойство поддерживается интерфейсом IXMLHTTPRequest3 .

[in] ullValue

Указывает время ожидания приложения в миллисекундах до истечения времени ожидания.

Значение Значение
XHR_PROP_NO_CRED_PROMPT
 Этот параметр может быть одним из значений из типа перечисления XHR_CRED_PROMPT , определенного в файле заголовка Msxml6.h .
  • XHR_CRED_PROMPT_ALL, если запрос учетных данных должен быть включен (по умолчанию).
  • XHR_CRED_PROMPT_NONE , следует ли отключить запрос учетных данных.
  • XHR_CRED_PROMPT_PROXY , если запрос учетных данных должен быть включен только для проверки подлинности прокси-сервера.
XHR_PROP_NO_AUTH
 Этот параметр может быть одним из значений из типа перечисления XHR_AUTH , определенного в файле заголовка Msxml6.h .
  • XHR_AUTH_ALL, включена ли проверка подлинности (по умолчанию).
  • XHR_AUTH_NONE , если проверка подлинности отключена.
  • XHR_AUTH_PROXY , если проверка подлинности должна быть включена только для проверки подлинности прокси-сервера.
XHR_PROP_TIMEOUT
Количество миллисекундах (до 0xFFFFFFFF), которое приложение ожидает до истечения времени ожидания.
XHR_PROP_NO_DEFAULT_HEADERS
  • FALSE(0x0) для включения добавления заголовков по умолчанию (по умолчанию).
  • ЗНАЧЕНИЕ TRUE(0x1), чтобы отключить добавление заголовков по умолчанию.
XHR_PROP_REPORT_REDIRECT_STATUS
  • FALSE(0x0), чтобы не сообщать о состоянии перенаправления (по умолчанию).
  • Значение TRUE(0x1), чтобы сообщить о состоянии перенаправления.
XHR_PROP_NO_CACHE
  • FALSE(0x0) для включения кэширования (по умолчанию).
  • Значение TRUE(0x1), чтобы отключить кэширование.
XHR_PROP_EXTENDED_ERROR
  • FALSE(0x0), чтобы не предоставлять расширенные ошибки (по умолчанию).
  • TRUE(0x1) для предоставления расширенных ошибок .
XHR_PROP_QUERY_STRING_UTF8
  • FALSE(0x0), чтобы не кодировать строку запроса в UTF-8 (по умолчанию).
  • ЗНАЧЕНИЕ TRUE(0x1) для кодирования строки запроса в UTF-8.
XHR_PROP_IGNORE_CERT_ERRORS
  • ЗНАЧЕНИЕ FALSE(0x0), чтобы не игнорировать ошибки сертификата (по умолчанию).
  • ЗНАЧЕНИЕ TRUE(0x1), чтобы игнорировать ошибки сертификата.

Возвращаемое значение

Возвращает S_OK при успешном выполнении.

Комментарии

Метод 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 [классические приложения | Приложения UWP], MSXML 6.0 и более поздних версий
Минимальная версия сервера Windows Server 2012 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header msxml6.h

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

IXMLHTTPRequest2

IXMLHTTPRequest3

OnHeadersAvailable

Открыть

Перечисление XHR_PROPERTY