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 |