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