IXMLHTTPRequest2::Send-Methode (msxml6.h)

  • Artikel

Sendet asynchron eine HTTP-Anforderung an den Server. Bei Erfolg werden Methoden auf der von der App implementierten IXMLHTTPRequest2Callback-Schnittstelle aufgerufen, um die Antwort zu verarbeiten.

Syntax

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

Parameter

[in, optional] pBody

Der Text der Nachricht, die mit der Anforderung gesendet wird. Dieser Stream wird gelesen, um Daten für Nicht-GET-Anforderungen hochzuladen. Legen Sie für Anforderungen, die keinen Upload erfordern, diesen Parameter auf NULL fest.

[in] cbBody

Die Länge der Nachricht, die mit der Anforderung gesendet wird, in Bytes. Legen Sie für Anforderungen, die keinen Upload erfordern, diesen Parameter auf 0 fest.

Rückgabewert

Gibt bei Erfolg S_OK zurück.

Bemerkungen

Die Open-Methode muss aufgerufen werden, bevor Send erfolgreich aufgerufen werden kann.

Da diese Methode asynchron ist, wird sie unmittelbar vor beginn der Verarbeitung der Anforderung zurückgegeben. Die Anwendung wird über die IXMLHTTPRequest2Callback-Schnittstelle benachrichtigt, wenn bei der Anforderungsverarbeitung Fortschritte gemacht werden.

Alternativen zur Verwendung von ISequentialStream für eine POST-Anforderung sind SHCreateMemStream/SHCreateStreamOnFile für Desktop-Apps und CreateStreamOverRandomAccessStream für Windows Store-Apps.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8 [Desktop-Apps | UWP-Apps],MSXML 6.0 und höher
Unterstützte Mindestversion (Server) Windows Server 2012 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile msxml6.h

Weitere Informationen

IXMLHTTPRequest2