Adaptateurs d’écouteur <listenerAdapters>

Vue d’ensemble

L’élément <listenerAdapters> spécifie les paramètres de configuration des adaptateurs d’écouteur pour Internet Information Services (IIS) 7. Les adaptateurs d’écouteur sont des composants qui établissent la communication entre les services d’écouteur de protocole non HTTP et le service d’activation des processus Windows (WAS). Les modifications apportées à l’élément <listenerAdapters> prennent effet uniquement lorsqu’un adaptateur d’écouteur se connecte à WAS. Dans la plupart des cas, cette connexion nécessite que le serveur soit redémarré.

Remarques :

• Le service de publication World Wide Web (W3SVC) contient des fonctionnalités spécifiques à HTTP pour IIS 7. Il n’utilise donc pas d’attributs <listenerAdapters> supplémentaires. - Le service FTP, qui ne nécessite pas le WAS, n’a pas d’entrée <listenerAdapters>.

Compatibilité

Version	Notes
IIS 10.0	L’élément <listenerAdapters> n’a fait l’objet d’aucune modification dans IIS 10.0.
IIS 8.5	L’élément <listenerAdapters> n’a fait l’objet d’aucune modification dans IIS 8.5.
IIS 8.0	L’élément <listenerAdapters> n’a fait l’objet d’aucune modification dans IIS 8.0.
IIS 7.5	L’élément <listenerAdapters> n’a fait l’objet d’aucune modification dans IIS 7.5.
IIS 7.0	L’élément <listenerAdapters> a été introduit dans IIS 7.0.
IIS 6.0	S/O

Programme d’installation

L’élément <listenerAdapters> est inclus dans l’installation par défaut d’IIS 7.

Procédure

Il n’existe aucune interface utilisateur pour l’ajout d’adaptateurs d’écouteur pour IIS 7. Pour obtenir des exemples d’ajout d’adaptateur d’écouteur par programmation, consultez la section Exemples de code de ce document.

Configuration

Attributs

Aucune.

Éléments enfants

Élément	Description
add	Élément facultatif. Spécifie la configuration d’un adaptateur d’écouteur.

Exemple Configuration

L’exemple de configuration suivant ajoute un adaptateur d’écouteur à un fournisseur de protocole Gopher et spécifie à la fois le nom de la DLL et sa fonction d’initialisation.

<system.applicationHost>
   <listenerAdapters>
      <add name="gopher"
         protocolManagerDll="%SystemRoot%\system32\inetsrv\gophersvc.dll"
         protocolManagerDllInitFunction="GopherInit" />
   </listenerAdapters>
</system.applicationHost>

Exemple de code

Les exemples de code suivants ajoutent un adaptateur d’écouteur à un fournisseur de protocole Gopher et spécifient à la fois le nom de la DLL et sa fonction d’initialisation.

AppCmd.exe

appcmd.exe set config -section:system.applicationHost/listenerAdapters /+"[name='gopher',protocolManagerDll='%SystemRoot%\system32\inetsrv\gophersvc.dll',protocolManagerDllInitFunction='GopherInit']" /commit:apphost

Remarque

Vous devez veiller à définir le paramètre commit sur apphost quand vous utilisez AppCmd.exe pour configurer ces paramètres. Cela valide les paramètres de configuration dans la section d’emplacement appropriée dans le fichier ApplicationHost.config.

C#

using System;
using System.Text;
using Microsoft.Web.Administration;

internal static class Sample
{
   private static void Main()
   {
      using (ServerManager serverManager = new ServerManager())
      {
         Configuration config = serverManager.GetApplicationHostConfiguration();
         ConfigurationSection listenerAdaptersSection = config.GetSection("system.applicationHost/listenerAdapters");
         ConfigurationElementCollection listenerAdaptersCollection = listenerAdaptersSection.GetCollection();

         ConfigurationElement addElement = listenerAdaptersCollection.CreateElement("add");
         addElement["name"] = @"gopher";
         addElement["protocolManagerDll"] = @"%SystemRoot%\system32\inetsrv\gophersvc.dll";
         addElement["protocolManagerDllInitFunction"] = @"GopherInit";
         listenerAdaptersCollection.Add(addElement);

         serverManager.CommitChanges();
      }
   }
}

VB.NET

Imports System
Imports System.Text
Imports Microsoft.Web.Administration

Module Sample

   Sub Main()
      Dim serverManager As ServerManager = New ServerManager
      Dim config As Configuration = serverManager.GetApplicationHostConfiguration
      Dim listenerAdaptersSection As ConfigurationSection = config.GetSection("system.applicationHost/listenerAdapters")
      Dim listenerAdaptersCollection As ConfigurationElementCollection = listenerAdaptersSection.GetCollection

      Dim addElement As ConfigurationElement = listenerAdaptersCollection.CreateElement("add")
      addElement("name") = "gopher"
      addElement("protocolManagerDll") = "%SystemRoot%\system32\inetsrv\gophersvc.dll"
      addElement("protocolManagerDllInitFunction") = "GopherInit"
      listenerAdaptersCollection.Add(addElement)

      serverManager.CommitChanges()
   End Sub

End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";
var listenerAdaptersSection = adminManager.GetAdminSection("system.applicationHost/listenerAdapters", "MACHINE/WEBROOT/APPHOST");
var listenerAdaptersCollection = listenerAdaptersSection.Collection;

var addElement = listenerAdaptersCollection.CreateNewElement("add");
addElement.Properties.Item("name").Value = "gopher";
addElement.Properties.Item("protocolManagerDll").Value = "%SystemRoot%\\system32\\inetsrv\\gophersvc.dll";
addElement.Properties.Item("protocolManagerDllInitFunction").Value = "GopherInit";
listenerAdaptersCollection.AddElement(addElement);

adminManager.CommitChanges();

VBScript

Set adminManager = WScript.CreateObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"
Set listenerAdaptersSection = adminManager.GetAdminSection("system.applicationHost/listenerAdapters", "MACHINE/WEBROOT/APPHOST")
Set listenerAdaptersCollection = listenerAdaptersSection.Collection

Set addElement = listenerAdaptersCollection.CreateNewElement("add")
addElement.Properties.Item("name").Value = "gopher"
addElement.Properties.Item("protocolManagerDll").Value = "%SystemRoot%\system32\inetsrv\gophersvc.dll"
addElement.Properties.Item("protocolManagerDllInitFunction").Value = "GopherInit"
listenerAdaptersCollection.AddElement(addElement)

adminManager.CommitChanges()