WebhostRegisterProtocol 함수

수신기 어댑터가 지원하는 프로토콜을 선언합니다.

구문

HRESULT WebhostRegisterProtocol(  
   IN LPCWSTR ProtocolId,  
   IN VOID* pListenerCallbacks,  
   IN VOID* pContext,  
   OUT DWORD* pProtocolHandle  
);  

매개 변수

ProtocolId
[IN] 이 수신기 어댑터가 지원하는 프로토콜을 포함하는 문자열입니다.

pListenerCallbacks
[IN] VOIDWEBHOST_LISTENER_CALLBACKS 구조체에 대한 포인터입니다.

pContext
[IN] 수신기 어댑터가 전달할 임 VOID 의 포인터입니다.

pProtocolHandle
[OUT] 이 프로토콜을 DWORD 나타내는 프로세스 고유 키를 포함하는 에 대한 포인터입니다.

반환 값

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

값	정의
S_OK	작업이 성공했음을 나타냅니다.
HRESULT_FROM_WIN32( ERROR_ALREADY_EXISTS )	이 프로토콜에 대해 이 프로세스에 등록된 수신기 어댑터가 이미 있음을 나타냅니다.
E_INVALIDARG	매개 변수 중 하나가 잘못되었음을 나타냅니다.
E_OUTOFMEMORY	힙 메모리가 소진되었음을 나타냅니다.

설명

수신기 어댑터를 시작할 때 함수를 먼저 호출 WebhostRegisterProtocol 해야 합니다. WebhostRegisterProtocol 는 비동기적이므로 성공적인 반환은 호출이 성공했음을 보장하지 않습니다. WAS(Windows Process Activation Service)는 PFN_WEBHOST_LISTENER_CONFIG_MANAGER_CONNECTED 함수를 사용하여 수신기에 성공적인 등록을 알렸습니다. PFN_WEBHOST_LISTENER_CONFIG_MANAGER_CONNECTED 이 호출에 매개 변수에 pListenerCallbacks 전달됩니다.

수신기 어댑터가 콜백 함수를 대기 PFN_WEBHOST_LISTENER_CONFIG_MANAGER_CONNECTED 하도록 제한 시간을 설정해야 합니다. 제한 시간이 만료되면 수신기 어댑터 서비스를 중지하고 실패한 것으로 표시해야 합니다. 이 호출의 성공적인 반환은 클라이언트 라이브러리가 Windows 프로세스 정품 인증 서비스를 기다리고 있으며 가능하면 연결됨을 나타냅니다.

이 콜백 함수에서 SERVICE_RUNNING 수신기 서비스 상태 설정해서는 안 됩니다. 초기화가 완료되고 프로토콜 수신기가 수신 대기하는 경우에만 서비스 상태 SERVICE_RUNNING 설정해야 합니다(일반적으로 PFN_WEBHOST_LISTENER_CONFIG_MANAGER_INITIALIZATION_COMPLETED 알림 후).

pContext 매개 변수는 콜백 함수가 호출될 때마다 수신기 어댑터에 전달됩니다. 동일한 콜백 구조를 사용하는 여러 프로토콜이 구현될 때 사용할 수 있습니다.

클라이언트 라이브러리가 Windows 프로세스 정품 인증 서비스에 연결하려면 다음 조건을 충족해야 합니다.

• Was.config 파일의 구성 섹션에서는 <listenerAdapters> 수신기 어댑터가 실행될 프로토콜 및 ID를 선언해야 합니다.

• Windows 프로세스 정품 인증 서비스가 실행 중이어야 합니다.

• 수신기 어댑터 서비스는 Windows 프로세스 정품 인증 서비스에 종속된 것으로 등록되어야 합니다.

요구 사항

형식	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

참고 항목

PFN_WEBHOST_LISTENER_CONFIG_MANAGER_INITIALIZATION_COMPLETED 함수
수신기 어댑터 내보낸 함수