Compartilhar via

Função WebhostRegisterProtocol

Declara o protocolo compatível com o adaptador do ouvinte.

Sintaxe

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

Parâmetros

ProtocolId
[IN] Uma cadeia de caracteres que contém o protocolo compatível com esse adaptador de ouvinte.

pListenerCallbacks
[IN] Um VOID ponteiro para a estrutura WEBHOST_LISTENER_CALLBACKS .

pContext
[IN] Um ponteiro arbitrário VOID que o adaptador do ouvinte passará.

pProtocolHandle
[OUT] Um ponteiro para um DWORD que contém a chave exclusiva do processo que representa esse protocolo.

Valor Retornado

Um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Valor Definição
S_OK Indica que a operação foi bem-sucedida.
HRESULT_FROM_WIN32( ERROR_ALREADY_EXISTS ) Indica que já há um adaptador de ouvinte registrado neste processo para esse protocolo.
E_INVALIDARG Indica que um dos parâmetros não é válido.
E_OUTOFMEMORY Indica que a memória do heap está esgotada.

Comentários

Você deve chamar a WebhostRegisterProtocol função primeiro quando iniciar um adaptador de ouvinte. WebhostRegisterProtocol é assíncrono, portanto, um retorno bem-sucedido não garante que a chamada tenha sido bem-sucedida. O WAS (Serviço de Ativação de Processo do Windows) notifica o ouvinte de registro bem-sucedido usando a função PFN_WEBHOST_LISTENER_CONFIG_MANAGER_CONNECTED . PFN_WEBHOST_LISTENER_CONFIG_MANAGER_CONNECTED é passado no pListenerCallbacks parâmetro para essa chamada.

Você deve definir um tempo limite para que o adaptador do ouvinte aguarde a PFN_WEBHOST_LISTENER_CONFIG_MANAGER_CONNECTED função de retorno de chamada. Se o tempo limite expirar, você deverá interromper o serviço de adaptador do ouvinte e marcá-lo como com falha. Um retorno bem-sucedido dessa chamada indica que a biblioteca de clientes está aguardando o Serviço de Ativação de Processo do Windows e se conectará quando possível.

Você não deve definir o serviço de ouvinte status como SERVICE_RUNNING dessa função de retorno de chamada. Você deve definir o serviço status como SERVICE_RUNNING somente quando a inicialização for concluída e o ouvinte de protocolo estiver escutando (normalmente após a notificação de PFN_WEBHOST_LISTENER_CONFIG_MANAGER_INITIALIZATION_COMPLETED).

O pContext parâmetro é passado para o adaptador do ouvinte sempre que uma função de retorno de chamada é invocada. Ele pode ser usado quando vários protocolos que usam a mesma estrutura de retorno de chamada são implementados.

Para que a biblioteca de clientes se conecte ao Serviço de Ativação de Processo do Windows, as seguintes condições devem ser atendidas:

  • A <listenerAdapters> seção de configuração no arquivo Was.config deve declarar o protocolo e a identidade sob a qual os adaptadores do ouvinte serão executados.

  • O Serviço de Ativação de Processo do Windows deve estar em execução.

  • Os serviços de adaptador de ouvinte devem ser registrados como dependentes do Serviço de Ativação de Processo do Windows.

Requisitos

Tipo Descrição
Cliente - IIS 7.0 no Windows Vista
- IIS 7.5 no Windows 7
- IIS 8.0 no Windows 8
- IIS 10.0 no Windows 10
Servidor - IIS 7.0 no Windows Server 2008
- IIS 7.5 no Windows Server 2008 R2
- IIS 8.0 no Windows Server 2012
- IIS 8.5 no Windows Server 2012 R2
- IIS 10.0 no Windows Server 2016
Produto - 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
parâmetro Listeneradapter.h

Consulte Também

Função PFN_WEBHOST_LISTENER_CONFIG_MANAGER_INITIALIZATION_COMPLETED
Funções exportadas do adaptador de ouvinte

  • Last updated on