IMFHttpDownloadSession ::CreateRequest, méthode (mfidl.h)

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

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 qui a été incluse dans l’URL.

[in] fBypassProxyCache

Si la valeur est TRUE, indique que la requête doit être transférée au serveur d’origine plutôt que d’envoyer une version mise en cache d’une ressource à partir d’un serveur proxy. Lorsque cet indicateur a la valeur TRUE, un en-tête « Pragma : no-cache » doit être ajouté à la requête. 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, la variante sécurisée du protocole doit être utilisée, le cas échéant. Par exemple, si le IMFHttpDownloadSession est pour HTTP/HTTPS, la définition de fSecure sur TRUE entraîne l’utilisation du protocole HTTPS. 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 est 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 renvoyée

La méthode retourne un HRESULT. Les valeurs possibles incluent, mais ne sont pas limitées à celles du tableau suivant.

Exigences

Voir également

IMFHttpDownloadSession