IMFHttpDownloadRequest::GetURL-Methode (mfidl.h)

  • Artikel

Gibt die URL zurück, die zum Senden der Anforderung verwendet wird.

Syntax

HRESULT GetURL(
  [out] LPWSTR *ppszURL
);

Parameter

[out] ppszURL

Die URL, die zum Senden der Anforderung an den Server verwendet wird. Beachten Sie, dass diese URL unterschiedlich sein kann, wenn der Server eine HTTP-Protokollumleitung ausgegeben hat. Der Arbeitsspeicher für pszURL muss mit CoTaskMemAlloc zugeordnet werden und wird von Media Foundation mit CoTaskMemFree freigegeben.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode BESCHREIBUNG
S_OK
 Die URL wurde erfolgreich zurückgegeben.
E_OUTOFMEMORY
 Es ist nicht genügend Arbeitsspeicher vorhanden, um den Vorgang abzuschließen.
E_POINTER
 Der ppszURL-Parameter ist ein ungültiger Zeiger.

Hinweise

Standardmäßig gibt GetURL eine URL zurück, die aus den Parametern synthetisiert wird, die von Media Foundation in den Methoden IMFHttpDownloadSession::SetServer und IMFHttpDownloadSession::CreateRequest bereitgestellt werden. Wenn der HTTP-Server die IMFHttpDownloadRequest jedoch an einen anderen Server umgeleitet hat (d. h. über die HTTP-Antwort "302 Siehe andere") gibt die GetURL-Methode die vom HTTP-Server angegebene URL zurück.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10, Version 1703 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Nicht unterstützt
Zielplattform Windows
Kopfzeile mfidl.h
Bibliothek Mfplat.lib; Mfplat.dll

Weitere Informationen

IMFHttpDownloadRequest