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

Статья
08/25/2023

Задает свойство для исходящего 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 при успешном выполнении.

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