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

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.

[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.

Configuration requise

Voir aussi

IMFHttpDownloadSession