WebhostCloseAllListenerChannelInstances 函式
要求此接聽程式通道的所有實例停止。
語法
HRESULT WebhostCloseAllListenerChannelInstances(
IN DWORD ProtocolHandle,
IN LPCWSTR AppPoolId,
IN DWORD ListenerChannelId
);
參數
ProtocolHandle
[IN] DWORD ，包含表示這個接聽程式通道之通訊協定的通訊協定控制碼。
AppPoolId
[IN]字串，包含這個接聽程式通道的應用程式集區識別碼。
ListenerChannelId
[IN]， DWORD 包含接聽程式配接器已要求停止的接聽程式通道識別碼。
傳回值
HRESULT。 可能的值包括 (但不限於) 下表中的這些值。
| 值 | 描述 |
|---|---|
| S_OK | 表示作業成功。 |
| E_INVALIDARG | 表示其中一個參數無效。 |
| HRESULT_FROM_WIN32 ( ERROR_NOT_FOUND) | 表示通訊協定尚未註冊。 |
| HRESULT_FROM_WIN32 (ERROR_PIPE_NOT_CONNECTED) | 表示接聽程式配接器未連線到 Windows 進程啟用服務。 |
備註
在沒有執行接聽程式通道的呼叫此函式時，不會傳回錯誤碼。
在下列情況下會呼叫此函式：
接聽程式配接器服務正在停止。
接聽程式配接器會依應用程式路由傳送，而且正在刪除應用程式。
正在刪除應用程式集區。
接聽程式配接器會依應用程式路由傳送，而應用程式會移至另一個應用程式集區。
規格需求
| 類型 | 描述 |
|---|---|
| Client | - 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 |
| 標頭 | Listeneradapter.h |
另請參閱
接聽程式配接器匯出函式
PFN_WEBHOST_LISTENER_APPLICATION_POOL_ALL_LISTENER_CHANNEL_INSTANCES_STOPPED函式