ListenerAdapterElement Class [IIS 7 and higher]

Specifies configuration settings for a listener adapter.

Syntax

class ListenerAdapterElement : CollectionElement

Methods

This class contains no methods.

Properties

The following table lists the properties exposed by the ListenerAdapterElement class.

Name

Description

Identity

A read/write string value that contains the account name that is used to secure the Windows Process Activation Service (WAS) communication channel between the listener service and the listener adapter.

Name

A read-only string value that contains the name of a listener adapter. The key property.

ProtocolManagerDll

A read/write string value that specifies the name of the DLL where the listener adapter code is located. The string value may be either a fully qualified path or the short name of the DLL, and the DLL may be either managed or native code. If the DLL cannot be found on disk by using standard search procedures that depend on DLL type, the function specified in the ProtocolManagerDllInitFunction property is not called.

ProtocolManagerDllInitFunction

A read/write string value that contains the name of the function to call on the custom listener adapter code. The function must reside in the DLL specified in the ProtocolManagerDll property.

Subclasses

This class contains no subclasses.

Remarks

Instances of this class are contained in the ListenerAdapters property of the ListenerAdaptersSection class.

Listener adapters are components that establish communication between non-HTTP protocol listeners and the Windows Process Activation Service (WAS). The World Wide Web Publishing Service (WWW service), which contains HTTP-specific functionality, does not use ListenerAdapterElement configuration settings.

Changes to ListenerAdapterElement take effect only when a listener adapter connects with WAS. In most cases, this connection requires that the server be restarted.

Inheritance Hierarchy

CollectionElement

   ListenerAdapterElement

Requirements

Type

Description

Client

Requires IIS 7 on Windows Vista.

Server

Requires IIS 7 on Windows Server 2008.

Product

IIS 7

MOF file

WebAdministration.mof

See Also

Reference

CollectionElement Class [IIS 7 and higher]

ListenerAdaptersSection Class [IIS 7 and higher]

ListenerAdapterElement