Método IXMLHTTPRequest2::Send (msxml6.h)
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 |