Partager via


Méthode IMFHttpDownloadRequest ::GetURL (mfidl.h)

Retourne l’URL utilisée pour l’envoi de la demande.

Syntaxe

HRESULT GetURL(
  [out] LPWSTR *ppszURL
);

Paramètres

[out] ppszURL

URL utilisée pour envoyer la demande au serveur. Notez que cette URL peut être différente si le serveur a émis une « redirection » du protocole HTTP. La mémoire de pszURL doit être allouée avec CoTaskMemAlloc et sera libérée par Media Foundation avec CoTaskMemFree.

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’URL a été retournée.
E_OUTOFMEMORY
La mémoire est insuffisante pour terminer l’opération.
E_POINTER
Le paramètre ppszURL est un pointeur non valide.

Remarques

Par défaut, GetURL retourne une URL qui est synthétisée à partir des paramètres fournis par Media Foundation dans les méthodes IMFHttpDownloadSession ::SetServer et IMFHttpDownloadSession ::CreateRequest . Toutefois, si le serveur HTTP a redirigé la demande IMFHttpDownloadRequest vers un autre serveur (par exemple, via une réponse HTTP « 302 See Other ») la méthode GetURL retourne l’URL spécifiée par le serveur HTTP.

Configuration requise

Condition requise Valeur
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

IMFHttpDownloadRequest