Méthode IMFHttpDownloadSession::CreateRequest (mfidl.h)

Article
08/24/2023

Appelée par Microsoft Media Foundation pour créer un objet qui implémente l’interface IMFHttpDownloadRequest , qui est utilisée pour envoyer une seule requête HTTP ou HTTPS. Étant donné que plusieurs demandes peuvent être nécessaires pour télécharger entièrement une ressource, Media Foundation peut appeler CreateRequest plusieurs fois sur le même instance IMFHttpDownloadSession. Media Foundation utilisera chaque instance IMFHttpDownloadRequest pour une seule demande.

Syntaxe

HRESULT CreateRequest(
  [in]           LPCWSTR                szObjectName,
  [in]           BOOL                   fBypassProxyCache,
  [in]           BOOL                   fSecure,
  [in, optional] LPCWSTR                szVerb,
  [in, optional] LPCWSTR                szReferrer,
                 IMFHttpDownloadRequest **ppRequest
);

Paramètres

[in] szObjectName

Pointeur vers une chaîne qui contient le nom de la ressource cible du verbe HTTP spécifié. Il s’agit généralement d’un nom de fichier, d’un module exécutable ou d’un spécificateur de recherche. La ressource cible commence toujours par un caractère de barre oblique et inclut toute chaîne de requête incluse dans l’URL.

[in] fBypassProxyCache

Si la valeur est TRUE, indique que la demande doit être transférée au serveur d’origine au lieu d’envoyer une version mise en cache d’une ressource à partir d’un serveur proxy. Lorsque cet indicateur est défini sur TRUE, un en-tête « Pragma: no-cache » doit être ajouté à la demande. Lors de la création d’une requête HTTP/1.1, un « Cache-Control: no-cache » doit également être ajouté.

[in] fSecure

Si la valeur est TRUE, entraîne l’utilisation de la variante sécurisée du protocole, le cas échéant. Par exemple, si IMFHttpDownloadSession est destiné à HTTP/HTTPS, la définition de fSecure sur TRUE entraîne l’utilisation de HTTPS par la requête. Sinon, la variante non sécurisée du protocole (dans cet exemple, HTTP) est utilisée.

[in, optional] szVerb

Pointeur vers une chaîne qui contient le verbe HTTP à utiliser dans la requête. Si ce paramètre a la valeur NULL, la fonction utilise GET comme verbe HTTP.

Note Cette chaîne doit être en majuscules. De nombreux serveurs traitent les verbes HTTP comme respectant la casse, et les requêtes de commentaires (RFC) de l’Internet Engineering Task Force (IETF) écrivent ces verbes à l’aide de caractères majuscules uniquement.

[in, optional] szReferrer

Pointeur vers une chaîne qui spécifie l’URL du document à partir duquel l’URL de la requête szObjectName a été obtenue. Si ce paramètre a la valeur NULL, aucun document de référence n’est spécifié.

ppRequest

Une fois la méthode retournée, ce paramètre est défini sur une interface IMFHttpDownloadRequest .

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	Les informations fournies ont été correctement stockées.
E_OUTOFMEMORY	La mémoire est insuffisante pour terminer l’opération.
MF_E_INVALIDREQUEST	La méthode a été appelée après close ou avant l’appel de SetServer .

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

IMFHttpDownloadSession

Share via