Partager via


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