WebhostOpenListenerChannelInstance 함수

이 애플리케이션 풀의 작업자 프로세스에서 수신기 채널을 시작하라는 요청입니다.

구문

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

매개 변수

ProtocolHandle
[IN] DWORD 수신기 채널에 대한 프로토콜 핸들을 포함하는 입니다.

AppPoolId
[IN] 수신기 채널의 애플리케이션 풀 ID를 포함하는 문자열입니다.

ListenerChannelId
[IN] DWORD 수신기 채널 식별자가 포함된 입니다.

ListenerChannelBlob
[IN] PBYTE 작업자 프로세스를 수신기에 연결하는 데 필요한 정보가 들어 있는 입니다. 데이터가 WAS(Windows Process Activation Service)에 표시되지 않습니다. 자세한 내용은 아래 설명 섹션을 참조하세요.

ListenerChannelBlobByteCount
[IN] DWORD 수신기 채널 BLOB의 바이트 수를 포함하는 입니다.

반환 값

HRESULT입니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.

값	설명
S_OK	작업이 성공했음을 나타냅니다.
E_INVALIDARG	매개 변수 중 하나가 잘못되었음을 나타냅니다.
HRESULT_FROM_WIN32( ERROR_NOT_FOUND)	프로토콜이 등록되지 않음을 나타냅니다.
HRESULT_FROM_WIN32(ERROR_PIPE_NOT_CONNECTED)	수신기 어댑터가 Windows 프로세스 정품 인증 서비스에 연결되어 있지 않음을 나타냅니다.

설명

이 함수는 수신기 채널이 첫 번째 요청을 수신하거나 Windows 프로세스 정품 인증 서비스가 수신기 어댑터에 수신기 채널의 다른 instance 시작할 수 있음을 알립니다.

매개 변수는 ListenerChannelBlob Windows 프로세스 정품 인증 서비스, 작업자 프로세스 및 프로토콜 관리자에 전달됩니다. 수신기 어댑터가 애플리케이션당 요청을 라우팅하는 경우 BLOB에는 프로세스 프로토콜 처리기가 프로토콜 관리자에게 전달해야 하는 애플리케이션 키가 포함될 수 있습니다. 프로토콜 관리자는 애플리케이션 도메인 프로토콜 처리기를 연결하려면 애플리케이션 키가 필요합니다. BLOB의 세부 정보는 프로토콜 작성기에 남아 있습니다.

기본적으로 Windows 프로세스 정품 인증 서비스는 겹치는 재활용 프로세스를 설정하며, 이 프로세스는 종료할 작업자 프로세스가 새 작업자 프로세스가 시작될 때까지 계속 실행됩니다. Windows 프로세스 활성화 서비스는 수신기 채널 BLOB을 저장하고 이를 사용하여 새 작업자 프로세스에 연결하도록 요청합니다. 즉, 수신기 채널이 연결된 여러 프로세스를 수락할 수 있어야 합니다.

Windows 프로세스 정품 인증 서비스는 수신기 채널이 애플리케이션과 어떻게 관련되는지 관리하지 않습니다(예: 수신기는 애플리케이션 풀당 많은 수신기 채널 또는 하나만 포함하도록 선택할 수 있음). 따라서 Windows 프로세스 정품 인증 서비스는 변경이 발생할 때 수신기 채널에 어떤 일이 일어나야 하는지 수신기 어댑터에 대해 결정할 수 없습니다. Windows 프로세스 정품 인증 서비스는 수신기 어댑터에 알리고 이러한 결정을 관리할 수 있도록 허용합니다.

수신기 채널 ACL(액세스 제어 목록)을 애플리케이션 풀의 ID로 설정해야 합니다.

요구 사항

형식	Description
클라이언트	- 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

참고 항목

수신기 어댑터 내보낸 함수