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 |
|---|---|
|
Das OBJEKT IMFHttpDownloadSession wurde erfolgreich erstellt. |
|
Der für den wszScheme-Parameter angegebene Wert ist falsch. |
|
Der ppDownloadSession-Parameter ist ein ungültiger Zeiger. |
|
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 |