Partager via


IMFHttpDownloadSessionProvider::CreateHttpDownloadSession, méthode (mfidl.h)

Appelé par Microsoft Media Foundation pour ouvrir les URL HTTP ou HTTPS au lieu d’utiliser l’implémentation par défaut.

Syntaxe

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

Paramètres

[in] wszScheme

Nom du protocole pour lequel une imfHttpDownloadSession est demandée. Microsoft Media Foundation spécifie le schéma de protocole de l’URL que l’application a fournie à Media Foundation Source Resolver. Les valeurs valides incluent « http » pour HTTP et « https » pour HTTPS. Les noms de schéma d’URL ne respectent généralement pas la casse.

[out] ppDownloadSession

En cas d’exécution réussie, le paramètre est défini sur un pointeur vers une interface IMFHttpDownloadSession . L’interface retournée est utilisée par Microsoft Media Foundation pour ouvrir une seule URL HTTP ou HTTPS.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour Description
S_OK
L’objet IMFHttpDownloadSession a été créé.
E_INVALIDARG
La valeur spécifiée pour le paramètre wszScheme est incorrecte.
E_POINTER
Le paramètre ppDownloadSession n’est pas un pointeur non valide.
E_OUTOFMEMORY
La mémoire est insuffisante pour terminer l’opération.

Notes

La spécification de « https » comme valeur de wszScheme n’implique pas que HTTPS sera utilisé pour une requête particulière, car cela est spécifié par demande dans IMFhttpDownloadSession::CreateRequest.

Configuration requise

   
Client minimal pris en charge Windows 10, version 1703 [applications de bureau uniquement]
Serveur minimal pris en charge Aucun pris en charge
Plateforme cible Windows
En-tête mfidl.h
Bibliothèque Mfplat.lib; Mfplat.dll

Voir aussi

IMFHttpDownloadSessionProvider