IHttpContext::GetServerVarChanges, méthode

Article
07/19/2023

Récupère les modifications apportées aux variables de serveur pour le contexte actuel.

Syntaxe

virtual HRESULT GetServerVarChanges(  
   IN DWORD dwOldChangeNumber,  
   OUT DWORD* pdwNewChangeNumber,  
   IN OUT DWORD* pdwVariableSnapShot,  
   IN OUT PCSTR** ppVariableNameSnapShot,  
   IN OUT PCWSTR** ppVariableValueSnapShot,  
   OUT DWORD* pdwDiffedVariables,  
   OUT DWORD** ppDiffedVariableIndices  
) = 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.

pdwVariableSnapShot
[IN] [OUT] Pointeur vers un DWORD qui contient le nombre de variables de serveur dans le instantané.

ppVariableNameSnapShot
[IN] [OUT] Pointeur vers l’adresse d’un tableau de chaînes qui contient les noms des variables de serveur qui ont été modifiées dans le instantané.

ppVariableValueSnapShot
[IN] [OUT] Pointeur vers l’adresse d’un tableau de chaînes qui contient les valeurs des variables de serveur qui ont été modifiées dans le instantané.

pdwDiffedVariables
[OUT] Pointeur vers un DWORD qui contient le nombre de variables de serveur qui ont changé.

ppDiffedVariableIndices
[OUT] Pointeur vers l’adresse d’un tableau de DWORD valeurs, terminé par une valeur –1, qui contient les index des variables de serveur qui ont changé.

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.

Remarques

IIS utilise la GetServerVarChanges méthode pour tester les modifications apportées aux variables du serveur HTTP depuis la dernière fois que les variables de serveur ont été examinées.

Notes

IIS utilise la GetServerVarChanges méthode pour synchroniser en interne les variables de serveur entre les appels au code natif et au code managé. Les développeurs ne doivent pas utiliser la méthode lors de la GetServerVarChanges création de leurs modules 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

IHttpContext, interface
IHttpContext::GetServerVariable, méthode

Partager via