IHttpRequest::GetHeaderChanges, méthode

Article
07/19/2023

Récupère les modifications apportées aux en-têtes de serveur pour la requête actuelle.

Syntaxe

virtual HRESULT GetHeaderChanges(  
   IN DWORD dwOldChangeNumber,  
   OUT DWORD* pdwNewChangeNumber,  
   IN OUT PCSTR knownHeaderSnapshot [HttpHeaderRequestMaximum],  
   IN OUT DWORD* pdwUnknownHeaderSnapShot,  
   IN OUT PCSTR** ppUnknownHeaderNameSnapShot,  
   IN OUT PCSTR** ppUnknownHeaderValueSnapShot,  
   __out_ecount(HttpHeaderRequestMaximum+1) DWORD diffedKnownHeaderIndices [HttpHeaderRequestMaximum+1],  
   OUT DWORD* pdwDiffedUnknownHeaders,  
   OUT DWORD** ppDiffedUnknownHeaderIndices  
) = 0;

Paramètres

dwOldChangeNumber
[IN] DWORD qui contient l’ancien numéro de modification.

pdwNewChangeNumber
[OUT] Pointeur vers un DWORD qui contient le nouveau numéro de modification.

knownHeaderSnapshot
[IN] [OUT] Pointeur vers un tableau de chaînes qui contient les instantané de tous les en-têtes connus. (Le tableau contient les nouveaux en-têtes lors de l’appel, et les anciens en-têtes lors du retour.)

pdwUnknownHeaderSnapShot
[IN] [OUT] Pointeur vers un DWORD qui contient le nombre d’en-têtes inconnus dans le instantané.

ppUnknownHeaderNameSnapShot
[IN] [OUT] Pointeur vers l’adresse d’un tableau de chaînes qui contient les noms de tous les en-têtes inconnus. (Le tableau contient les nouveaux en-têtes lors de l’appel, et les anciens en-têtes lors du retour.)

ppUnknownHeaderValueSnapShot
[IN] [OUT] Pointeur vers l’adresse d’un tableau de chaînes qui contient une liste de toutes les valeurs d’en-tête dans le instantané.

diffedKnownHeaderIndices
[OUT] Tableau de DWORD valeurs, terminées par une valeur –1, qui contiennent les index des en-têtes qui ont changé dans la liste des en-têtes connus.

pdwDiffedUnknownHeaders
[OUT] Pointeur vers une DWORD valeur qui contient le nombre d’en-têtes inconnus qui ont changé.

ppDiffedUnknownHeaderIndices
[OUT] Pointeur vers l’adresse d’un tableau de DWORD valeurs, terminées par une valeur –1, qui contient les index des en-têtes qui ont changé dans la liste des en-têtes inconnus.

Valeur renvoyée

Élément HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Valeur	Description
S_OK	Indique que l’opération a réussi.
ERROR_NOT_ENOUGH_MEMORY	Indique que la mémoire est insuffisante pour effectuer l’opération.

Remarques

IIS utilise la GetHeaderChanges méthode pour tester les modifications apportées aux en-têtes HTTP depuis la dernière fois que les en-têtes ont été examinés.

Notes

IIS utilise la GetHeaderChanges méthode pour synchroniser en interne les en-têtes entre les appels au code natif et au code managé. Vous ne devez pas utiliser la GetHeaderChanges méthode lorsque vous créez un module HTTP.

Spécifications

Type	Description
Client	- IIS 7.0 sur Windows Vista - IIS 7.5 sur Windows 7 - IIS 8.0 sur Windows 8 - IIS 10.0 sur Windows 10
Serveur	- IIS 7.0 sur Windows Server 2008 - IIS 7.5 sur Windows Server 2008 R2 - IIS 8.0 sur Windows Server 2012 - IIS 8.5 sur Windows Server 2012 R2 - IIS 10.0 sur Windows Server 2016
Produit	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 - IIS Express 7.5, IIS Express 8.0, IIS Express 10.0
En-tête	Httpserv.h

Voir aussi

IHttpRequest, interface
IHttpRequest::GetHeader, méthode
IHttpResponse::GetHeader, méthode
IHttpResponse::GetHeaderChanges, méthode

Partager via