Método IXMLHTTPRequest2::Send (msxml6.h)

  • Artículo

Envía una solicitud HTTP al servidor de forma asincrónica. Si se ejecuta correctamente, se llama a los métodos de la interfaz IXMLHTTPRequest2Callback implementada por la aplicación para procesar la respuesta.

Sintaxis

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

Parámetros

[in, optional] pBody

El cuerpo del mensaje que se envía con la solicitud. Esta secuencia se lee para cargar datos para solicitudes que no son GET . Para las solicitudes que no requieren carga, establezca este parámetro en NULL.

[in] cbBody

Longitud, en bytes, del mensaje que se envía con la solicitud. Para las solicitudes que no requieren carga, establezca este parámetro en 0.

Valor devuelto

Devuelve S_OK si se realiza correctamente.

Comentarios

Se debe llamar al método Open antes de que se pueda llamar correctamente a Send .

Dado que este método es asincrónico, se devuelve inmediatamente antes de que la solicitud se haya iniciado el procesamiento. La aplicación recibirá una notificación a través de la interfaz IXMLHTTPRequest2Callback cuando se realice el progreso en el procesamiento de solicitudes.

Entre las alternativas al uso de ISequentialStream para una solicitud POST se incluyen SHCreateMemStream/SHCreateStreamOnFile para aplicaciones de escritorio y CreateStreamOverRandomAccessStream para aplicaciones de la Tienda Windows.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8 [aplicaciones de escritorio | Aplicaciones para UWP],MSXML 6.0 y versiones posteriores
Servidor mínimo compatible Windows Server 2012 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado msxml6.h

Consulte también

IXMLHTTPRequest2