PFN_WEBHOST_LISTENER_APPLICATION_POOL_ALL_LISTENER_CHANNEL_INSTANCES_STOPPED Function

Article
03/09/2018

Notifies the listener adapter that all instances of a specific listener channel have been stopped.

Syntax

typedef VOID(  
   * PFN_WEBHOST_LISTENER_APPLICATION_POOL_ALL_LISTENER_CHANNEL_INSTANCES_STOPPED)(  
   IN VOID* pContext,  
   IN LPCWSTR AppPoolId,  
   IN DWORD ListenerChannelId  
);

Parameters

pContext
[IN] A pointer to a VOID context that the listener adapter passed to WebhostRegisterProtocol.

AppPoolId
[IN] A pointer to a string that contains the application pool for the stopped listener channels.

ListenerChannelId
[IN] A DWORD that contains the listener channel ID for the listener channel that no longer has any instances.

Return Value

VOID.

Remarks

When the Service Control Manager (SCM) notifies a listener adapter to stop, the listener adapter should wait for the PFN_WEBHOST_LISTENER_APPLICATION_POOL_ALL_LISTENER_CHANNEL_INSTANCES_STOPPED notification before stopping; otherwise, if other listener channels are in use, the listener adapter may encounter conflicts when it attempts to restart.

This notification will occur only if the WebhostCloseAllListenerChannelInstances function has been called.

The Windows Process Activation Service (WAS) calls this function asynchronously and does not wait for the completion of the notification.

Requirements

Type	Description
Client	- IIS 7.0 on Windows Vista - IIS 7.5 on Windows 7 - IIS 8.0 on Windows 8 - IIS 10.0 on Windows 10
Server	- IIS 7.0 on Windows Server 2008 - IIS 7.5 on Windows Server 2008 R2 - IIS 8.0 on Windows Server 2012 - IIS 8.5 on Windows Server 2012 R2 - IIS 10.0 on Windows Server 2016 Technical Preview
Product	- 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
Header	Listeneradapter.h