WebhostCloseAllListenerChannelInstances 函数

请求停止此侦听器通道的所有实例。

语法

HRESULT WebhostCloseAllListenerChannelInstances(  
   IN DWORD ProtocolHandle,  
   IN LPCWSTR AppPoolId,  
   IN DWORD ListenerChannelId  
);  

parameters

ProtocolHandle
[IN]一个 DWORD ,它包含表示此侦听器通道协议的协议句柄。

AppPoolId
[IN]包含此侦听器通道的应用程序池 ID 的字符串。

ListenerChannelId
[IN]一个 DWORD ,它包含侦听器适配器请求停止的侦听器通道 ID。

返回值

HRESULT。 可能的值包括(但并不限于)下表中的项。

说明
S_OK 指示操作成功。
E_INVALIDARG 指示其中一个参数无效。
HRESULT_FROM_WIN32 ( ERROR_NOT_FOUND) 指示协议尚未注册。
HRESULT_FROM_WIN32 (ERROR_PIPE_NOT_CONNECTED) 指示侦听器适配器未连接到 Windows 进程激活服务。

备注

在没有运行侦听器通道的情况下调用此函数不会返回错误代码。

在以下情况下调用此函数:

  • 侦听器适配器服务正在停止。

  • 侦听器适配器按应用程序路由,并且正在删除该应用程序。

  • 正在删除应用程序池。

  • 侦听器适配器按应用程序路由,应用程序将移动到另一个应用程序池。

要求

类型 说明
客户端 - Windows Vista 上的 IIS 7.0
- Windows 7 上的 IIS 7.5
- Windows 8 上的 IIS 8.0
- Windows 10 上的 IIS 10.0
服务器 - Windows Server 2008 上的 IIS 7.0
- Windows Server 2008 R2 上的 IIS 7.5
- Windows Server 2012 上的 IIS 8.0
- Windows Server 2012 R2 上的 IIS 8.5
- Windows Server 2016 上的 IIS 10.0
产品 - 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

另请参阅

侦听器适配器导出的函数
PFN_WEBHOST_LISTENER_APPLICATION_POOL_ALL_LISTENER_CHANNEL_INSTANCES_STOPPED 函数