Listener

A listener is used by the client to accept an incoming channel from a service.

To create a listener, you specify the channel type as a WS_CHANNEL_TYPE enumeration value, the binding information, and the URL to listen on.

To start listening on the URL, call the WsOpenListener function.

To accept incoming communications, call WsAcceptChannel.

To cancel pending IO for a listener, call WsAbortListener.

For information on the state transitions for a listener, see the WS_LISTENER_STATE enumeration.

The following callbacks are part of the listener:

• WS_ABORT_LISTENER_CALLBACK
• WS_ACCEPT_CHANNEL_CALLBACK
• WS_CLOSE_LISTENER_CALLBACK
• WS_CREATE_CHANNEL_FOR_LISTENER_CALLBACK
• WS_CREATE_LISTENER_CALLBACK
• WS_FREE_LISTENER_CALLBACK
• WS_GET_LISTENER_PROPERTY_CALLBACK
• WS_OPEN_LISTENER_CALLBACK
• WS_RESET_LISTENER_CALLBACK
• WS_SET_LISTENER_PROPERTY_CALLBACK

The following enumerations are part of the listener:

• WS_IP_VERSION
• WS_LISTENER_PROPERTY_ID
• WS_LISTENER_STATE

The following functions are part of the listener:

• WsAbortListener
• WsAcceptChannel
• WsCloseListener
• WsCreateListener
• WsFreeListener
• WsGetListenerProperty
• WsOpenListener
• WsResetListener
• WsSetListenerProperty

The following handle is part of the listener:

• WS_LISTENER

The following structures are part of the listener:

• WS_CUSTOM_LISTENER_CALLBACKS
• WS_DISALLOWED_USER_AGENT_SUBSTRINGS
• WS_HOST_NAMES
• WS_LISTENER_PROPERTIES
• WS_LISTENER_PROPERTY