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

  • Статья

Асинхронно отправляет HTTP-запрос на сервер. При успешном выполнении для обработки ответа вызываются методы в интерфейсе IXMLHTTPRequest2Callback , реализованные приложением.

Синтаксис

HRESULT Send(
  [in, optional] ISequentialStream *pBody,
  [in]           ULONGLONG         cbBody
);

Параметры

[in, optional] pBody

Текст сообщения, отправляемого в запросе. Этот поток считывается для отправки данных для запросов, отличных от GET . Для запросов, которые не требуют отправки, присвойте этому параметру значение NULL.

[in] cbBody

Длина (в байтах) сообщения, отправляемого с запросом. Для запросов, которые не требуют отправки, задайте для этого параметра значение 0.

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

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

Комментарии

Метод Open должен быть вызван до успешного вызова метода Send .

Так как этот метод является асинхронным, он возвращается непосредственно перед началом обработки запроса. Приложение будет получать уведомления через интерфейс IXMLHTTPRequest2Callback по мере выполнения обработки запроса.

Альтернативными вариантами использования ISequentialStream для запроса POST являются SHCreateMemStream/SHCreateStreamOnFile для классических приложений и CreateStreamOverRandomAccessStream для приложений Магазина Windows.

Требования

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

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

IXMLHTTPRequest2