IMFHttpDownloadRequest ::QueryHeader, méthode (mfidl.h)

Appelé par Microsoft Media Foundation pour récupérer les valeurs des en-têtes HTTP spécifiés à partir de la réponse à une requête HTTP ou HTTPS envoyée précédemment. Media Foundation appelle cette méthode uniquement après avoir appelé correctement la méthode EndReceiveResponse .

Syntaxe

HRESULT QueryHeader(
  [in]  LPCWSTR szHeaderName,
  [in]  DWORD   dwIndex,
  [out] LPWSTR  *ppszHeaderValue
);

Paramètres

[in] szHeaderName

Nom de l’en-tête HTTP pour lequel la valeur est interrogée.

[in] dwIndex

Numéro d’index de l’en-tête spécifié, dans le cas où la réponse contient plusieurs en-têtes portant le même nom. La valeur 0 indique que la valeur du premier en-tête portant le nom spécifié est demandée, 1 indique que le deuxième en-tête est demandé, et ainsi de suite.

[out] ppszHeaderValue

Défini sur la valeur de l’en-tête demandé, sans inclure les caractères de retour chariot ou de saut de ligne. La mémoire de ppszHeaderValue doit être allouée avec CoTaskMemAlloc et sera libérée par Media Foundation avec CoTaskMemFree.

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

IMFHttpDownloadRequest