Freigeben über


IXMLHTTPRequest2Callback::OnRedirect-Methode (msxml6.h)

Tritt auf, wenn ein Client eine HTTP-Anforderung sendet, die der Server an eine neue URL umleitet.

Syntax

HRESULT OnRedirect(
  [in, optional] IXMLHTTPRequest2 *pXHR,
  [in]           const WCHAR      *pwszRedirectUrl
);

Parameter

[in, optional] pXHR

Das umgeleitete HTTP-Anforderungsobjekt.

[in] pwszRedirectUrl

Die neue URL für die HTTP-Anforderung.

Rückgabewert

Gibt bei Erfolg S_OK zurück.

Hinweis Diese Rückruffunktion darf keine Ausnahmen auslösen.
 

Hinweise

Wenn die Anforderungsumleitung nicht zulässig ist, können Sie die Abort-Methode für das pXHR-Objekt aufrufen.

XMLHTTPRequest2 erzwingt maximal 100 Umanweisungen für jede Anforderung. Jede Umbeschreibung oberhalb dieses Grenzwerts generiert ein OnError-Ereignis . Anwendungen haben keinen Zugriff auf die Header für eine erneute Wegbeschreibung.

Sobald die endgültige Umleitung abgeschlossen ist und die endgültige URL erreicht wurde, empfängt die Anwendung einen OnHeadersAvailable-Rückruf .

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

Abort-Methode

IXMLHTTPRequest2Callback

OnError-Ereignis

OnHeadersAvailable-Ereignis