Freigeben über


IMFHttpDownloadSessionProvider::CreateHttpDownloadSession-Methode (mfidl.h)

Wird von microsoft Media Foundation aufgerufen, um HTTP- oder HTTPS-URLs anstelle der Standardimplementierung zu öffnen.

Syntax

HRESULT CreateHttpDownloadSession(
  [in]  LPCWSTR                wszScheme,
  [out] IMFHttpDownloadSession **ppDownloadSession
);

Parameter

[in] wszScheme

Der Name des Protokolls, für das eine IMFHttpDownloadSession angefordert wird. Microsoft Media Foundation gibt das Protokollschema der URL an, die von der Anwendung den Media Foundation-Quelllöser bereitgestellt hat. Gültige Werte sind "http" für HTTP und "https" für HTTPS. Bei URL-Schemanamen wird die Groß-/Kleinschreibung in der Regel nicht beachtet.

[out] ppDownloadSession

Bei erfolgreicher Ausführung wird der Parameter auf einen Zeiger auf eine IMFHttpDownloadSession-Schnittstelle festgelegt. Die zurückgegebene Schnittstelle wird von Microsoft Media Foundation verwendet, um eine einzelne HTTP- oder HTTPS-URL zu öffnen.

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
Das OBJEKT IMFHttpDownloadSession wurde erfolgreich erstellt.
E_INVALIDARG
Der für den wszScheme-Parameter angegebene Wert ist falsch.
E_POINTER
Der ppDownloadSession-Parameter ist ein ungültiger Zeiger.
E_OUTOFMEMORY
Es ist nicht genügend Arbeitsspeicher vorhanden, um den Vorgang abzuschließen.

Hinweise

Die Angabe von "https" als Wert von wszScheme bedeutet nicht, dass HTTPS für eine bestimmte Anforderung verwendet wird, da dies pro Anforderung in IMFhttpDownloadSession::CreateRequest angegeben wird.

Anforderungen

   
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

IMFHttpDownloadSessionProvider