Функция WebhostOpenListenerChannelInstance

Запрашивает запуск канала прослушивателя в рабочем процессе для этого пула приложений.

Синтаксис

HRESULT WebhostOpenListenerChannelInstance(  
   IN DWORD ProtocolHandle,  
   IN LPCWSTR AppPoolId,  
   IN DWORD ListenerChannelId,  
   IN PBYTE ListenerChannelBlob,  
   IN DWORD ListenerChannelBlobByteCount  
);  

Параметры

ProtocolHandle
[IN] Объект DWORD , содержащий дескриптор протокола для канала прослушивателя.

AppPoolId
[IN] Строка, содержащая идентификатор пула приложений для канала прослушивателя.

ListenerChannelId
[IN] Объект DWORD , содержащий идентификатор канала прослушивателя.

ListenerChannelBlob
[IN] Объект , PBYTE содержащий сведения, необходимые для подключения рабочего процесса к прослушивателю. Данные не видны службе активации windows (WAS). Дополнительные сведения см. в разделе Примечания ниже.

ListenerChannelBlobByteCount
[IN] Объект , DWORD содержащий количество байтов в большом двоичном объекте канала прослушивателя.

Возвращаемое значение

Объект HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Значение	Описание:
S_OK	Указывает, что операция прошла успешно.
E_INVALIDARG	Указывает, что один из параметров недопустим.
HRESULT_FROM_WIN32( ERROR_NOT_FOUND)	Указывает, что протокол не зарегистрирован.
HRESULT_FROM_WIN32(ERROR_PIPE_NOT_CONNECTED)	Указывает, что адаптер прослушивателя не подключен к службе активации процессов Windows.

Комментарии

Функция вызывается, когда канал прослушивателя получает свой первый запрос или когда служба активации процессов Windows уведомляет адаптер прослушивателя о том, что он может запустить другой экземпляр канала прослушивателя.

Параметр ListenerChannelBlob передается в службу активации процессов Windows, рабочий процесс и диспетчер протоколов. Если адаптер прослушивателя перенаправит запросы для каждого приложения, большой двоичный объект, вероятно, будет содержать ключ приложения, который обработчику протокола процесса потребуется передать диспетчеру протоколов. Диспетчеру протоколов требуется ключ приложения для подключения обработчика протокола домена приложения. Сведения о большом двоичном объекте остаются в записи протокола.

По умолчанию служба активации процессов Windows устанавливает перекрывающийся процесс перезапуска, в котором рабочий процесс, который необходимо завершить, выполняется до тех пор, пока не будет запущен новый рабочий процесс. Служба активации процессов Windows сохраняет большой двоичный объект канала прослушивателя и будет использовать его, чтобы запросить подключение к новому рабочему процессу. Это означает, что канал прослушивателя должен иметь возможность принимать несколько процессов, подключающихся к нему.

Служба активации процессов Windows не управляет связью канала прослушивателя с приложением (например, прослушиватель может выбрать несколько каналов прослушивателя для каждого пула приложений или только один). Поэтому служба активации процессов Windows не может определить для адаптера прослушивателя, что должно происходить с каналами прослушивателя при внесении изменений. Служба активации процессов Windows просто уведомит адаптер прослушивателя и позволит ему управлять этими решениями.

Вам потребуется задать для списков управления доступом (ACL) каналов прослушивателя удостоверение пула приложений.

Требования

Тип	Описание
клиент	— IIS 7.0 в Windows Vista — IIS 7.5 в Windows 7 — IIS 8.0 в Windows 8 — IIS 10.0 в Windows 10
Сервер	— IIS 7.0 в Windows Server 2008 — IIS 7.5 в Windows Server 2008 R2 — IIS 8.0 в Windows Server 2012 — IIS 8.5 в Windows Server 2012 R2 — IIS 10.0 в Windows Server 2016
Продукт	— 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

См. также:

Экспортированные функции адаптера прослушивателя