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