Share via

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

  • Artigo

Envia uma solicitação HTTP para o servidor de forma assíncrona. Com êxito, os métodos na interface IXMLHTTPRequest2Callback implementada pelo aplicativo são chamados para processar a resposta.

Sintaxe

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

Parâmetros

[in, optional] pBody

O corpo da mensagem que está sendo enviada com a solicitação. Esse fluxo é lido para carregar dados para solicitações não GET . Para solicitações que não exigem upload, defina esse parâmetro como NULL.

[in] cbBody

O comprimento, em bytes, da mensagem que está sendo enviada com a solicitação. Para solicitações que não exigem carregamento, defina esse parâmetro como 0.

Retornar valor

Retornará S_OK se houver êxito.

Comentários

O método Open deve ser chamado antes que Send possa ser chamado com êxito.

Como esse método é assíncrono, ele retorna imediatamente antes que a solicitação inicie o processamento. O aplicativo será notificado por meio da interface IXMLHTTPRequest2Callback à medida que o progresso for feito no processamento da solicitação.

As alternativas ao uso de ISequentialStream para uma solicitação POST incluem SHCreateMemStream/SHCreateStreamOnFile para aplicativos da área de trabalho e CreateStreamOverRandomAccessStream para aplicativos da Windows Store.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [aplicativos da área de trabalho | Aplicativos UWP], MSXML 6.0 e posterior
Servidor mínimo com suporte Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho msxml6.h

Confira também

IXMLHTTPRequest2