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

Article
08/24/2023

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 précédemment envoyée. Media Foundation appelle cette méthode uniquement après avoir correctement appelé 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é, pour 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 avec 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éfinissez 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 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	La valeur de l’en-tête spécifié avec l’index spécifié a été retournée.
E_OUTOFMEMORY	La mémoire est insuffisante pour terminer l’opération.
E_POINTER	Le paramètre ppszHeaderValue est un pointeur non valide.
MF_E_OUT_OF_RANGE	La valeur du paramètre dwIndex est hors limites.

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

IMFHttpDownloadRequest

Partager via