IXMLHTTPRequest2 ::Send, méthode (msxml6.h)

Envoie une requête HTTP au serveur de façon asynchrone. En cas de réussite, les méthodes de l’interface IXMLHTTPRequest2Callback implémentées par l’application sont appelées pour traiter la réponse.

Syntaxe

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

Paramètres

[in, optional] pBody

Corps du message envoyé avec la demande. Ce flux est lu afin de charger des données pour les requêtes non-GET . Pour les demandes qui ne nécessitent pas de chargement, définissez ce paramètre sur NULL.

[in] cbBody

Longueur, en octets, du message envoyé avec la demande. Pour les demandes qui ne nécessitent pas de chargement, définissez ce paramètre sur 0.

Valeur retournée

Renvoie S_OK en cas de réussite.

Remarques

La méthode Open doit être appelée avant que Send puisse être appelé avec succès.

Étant donné que cette méthode est asynchrone, elle retourne immédiatement avant le début du traitement de la requête. L’application est avertie par le biais de l’interface IXMLHTTPRequest2Callback à mesure que la progression est effectuée dans le traitement de la demande.

Les alternatives à l’utilisation d’ISequentialStream pour une requête POST incluent SHCreateMemStream/SHCreateStreamOnFile pour les applications de bureau et CreateStreamOverRandomAccessStream pour les applications du Windows Store.

Configuration requise

Voir aussi

IXMLHTTPRequest2