Compartilhar via


Função WebhostUnregisterProtocol

Solicita que um protocolo seja cancelado quando um adaptador de ouvinte estiver sendo desligado.

Sintaxe

HRESULT WebhostUnregisterProtocol(  
   IN DWORD ProtocolHandle  
);  

Parâmetros

ProtocolHandle
[IN] Um DWORD que representa o protocolo a ser cancelado.

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 nesse processo para esse protocolo.
HRESULT_FROM_WIN32( ERROR_NOT_FOUND ) Indica que o protocolo não foi encontrado.

Comentários

Antes de chamar essa função, o adaptador do ouvinte deve executar as seguintes tarefas:

  1. Solicite que todos os canais de ouvinte parem (chamando a função WebhostCloseAllListenerChannelInstances ).

  2. Aguarde a notificação do Serviço de Ativação de Processo do Windows da função de retorno de chamada PFN_WEBHOST_LISTENER_APPLICATION_POOL_ALL_LISTENER_CHANNEL_INSTANCES_STOPPED. Esse retorno de chamada confirma que todas as instâncias do canal do ouvinte foram interrompidas.

Requisitos

Type 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ções exportadas do adaptador de ouvinte