IHttpServer Interface

Représente le contexte de traitement des opérations de niveau global.

Syntaxe

class IHttpServer  

Méthodes

Le tableau suivant répertorie les méthodes exposées par l’interface IHttpServer .

Nom	Description
AddFragmentToCache	Ajoute une structure HTTP_DATA_CHUNK au cache.
AssociateWithThreadPool	Associe une opération d’achèvement asynchrone au pool de threads.
DecrementThreadCount	Décrémente le nombre de threads pour le pool de threads.
DispenseContainer	Retourne un conteneur de contexte qui peut être distribué.
DoCacheOperation	Effectue une opération de cache spécifique.
FlushKernelCache	Vide le cache du noyau pour un identificateur de ressource uniforme (URI) spécifique.
GetAppPoolName	Récupère le nom du pool d’applications pour la requête actuelle.
GetConfigObject	Récupère l’objet de configuration pour le contexte actuel.
GetFileInfo	Renvoie une interface IHttpFileInfo pour un chemin de fichier spécifique.
GetManagedType	Récupère le type managé pour un site spécifique et l’URI (Uniform Resource Identifier).
GetPerfCounterInfo	Récupère une interface IHttpPerfCounterInfo .
GetProtocolManagerCustomInterface	Récupère une interface personnalisée pour un gestionnaire de protocoles.
GetTraceContext	Récupère une interface IHttpTraceContext .
GetWorkerProcessSettings	Récupère une interface IWpfSettings .
IncrementThreadCount	Incrémente le nombre de threads pour le pool de threads.
IsCommandLineLaunch	Teste si le processus de travail a été lancé à partir de la ligne de commande.
NotifyConfigurationChange	Déclenche une notification indiquant qu’un chemin de configuration a changé.
NotifyCustomNotification	Déclenche une notification de niveau global personnalisée.
NotifyFileChange	Déclenche une notification indiquant qu’un fichier a changé.
ReadFragmentFromCache	Récupère un fragment spécifique du cache.
RecycleApplication	Recycle une application.
RecycleProcess	Recycle le processus de travail qui gère la demande actuelle.
RegisterFileChangeMonitor	Inscrit une notification de modification de fichier pour un répertoire particulier.
RemoveFragmentFromCache	Supprime un fragment spécifique du cache.
ReportUnhealthy	Signale que le processus de travail est défectueux.
SatisfaitPrecondition	Détermine si une condition préalable spécifique a été remplie pour la demande actuelle.

Classes dérivées

Nom	Description
IHttpServer2	Représente le contexte de traitement des opérations de niveau global et permet de récupérer des fichiers de configuration, des interfaces étendues, des métadonnées, des jetons et l’infrastructure de processus de travail.

Remarques

L’interface IHttpServer représente l’interface programmatique main pour les modules HTTP afin d’accéder aux informations sur le contexte de niveau global actuel. Cette interface récupère plusieurs interfaces supplémentaires que vous pouvez utiliser lorsque vous écrivez des modules HTTP. Par exemple, les GetFileInfo méthodes et GetPerfCounterInfo récupèrent, respectivement, les IHttpFileInfo interfaces et IHttpPerfCounterInfo pour le contexte global. Ces interfaces permettent aux développeurs de récupérer une interface de fichier pour un fichier spécifique ou une interface pour les compteurs de performances.

IIS 7 permet aux développeurs de redémarrer une application, de redémarrer un processus worker ou de signaler le contexte actuel comme défectueux. Cette fonctionnalité est exposée, respectivement, par le biais des RecycleApplicationméthodes , RecycleProcesset ReportUnhealthy .

L’interface IHttpServer fournit plusieurs méthodes qui permettent aux développeurs de manipuler le cache IIS. Ces méthodes sont les AddFragmentToCacheméthodes , FlushKernelCacheDoCacheOperation, , ReadFragmentFromCacheet RemoveFragmentFromCache .

Notes

Http.sys gère et possède le cache de fragments. À tout moment, Http.sys pouvez remplacer ou supprimer les informations que vous avez invité à stocker. Il n’existe actuellement aucun moyen de verrouiller les informations dans le cache de fragments en tant qu’informations non volatiles.

Les développeurs peuvent utiliser les GetAppPoolNameméthodes , GetManagedType, GetWorkerProcessSettingset SatisfiesPrecondition pour récupérer des informations à partir des paramètres de configuration du contexte actuel.

L’interface IHttpServer fournit également les NotifyConfigurationChangeméthodes , NotifyFileChange, NotifyCustomNotification qui permettent aux développeurs de déclencher des notifications pour les modifications de configuration, les modifications de fichier ou une condition de notification personnalisée, respectivement.

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

Interfaces principales du serveur web