Compartilhar via

Função WsCloseListener (webservices.h)

  • Artigo

Faz com que o ouvinte especificado pare de escutar.

Sintaxe

HRESULT WsCloseListener(
  [in]           WS_LISTENER            *listener,
  [in, optional] const WS_ASYNC_CONTEXT *asyncContext,
  [in, optional] WS_ERROR               *error
);

Parâmetros

[in] listener

Ponteiro para uma estrutura WS_LISTENER que representa o ouvinte a ser fechado.

[in, optional] asyncContext

Ponteiro para uma estrutura WS_ASYNC_CONTEXT que contém informações para invocar a função de forma assíncrona. Passe NULL para invocar a função de forma síncrona.

[in, optional] error

Ponteiro para uma estrutura WS_ERROR que recebe informações de erro adicionais se a função falhar.

Retornar valor

Se a função for bem-sucedida, ela retornará NO_ERROR; caso contrário, ele retornará um código de erro HRESULT.

Código de retorno Descrição
WS_S_ASYNC
 A operação assíncrona ainda está pendente.
WS_E_OPERATION_ABORTED
 O fechamento foi anulado por uma chamada para WsAbortListener quando o ouvinte estava fechando.
WS_E_INVALID_OPERATION
 O ouvinte estava em um estado inapropriado.
WS_E_OPERATION_TIMED_OUT
 A operação não foi concluída dentro do tempo alocado.
E_INVALIDARG
 Um ou mais argumentos são inválidos.
Outros erros
Essa função pode retornar outros erros não listados acima.

Comentários

Depois que o ouvinte for fechado, o ouvinte poderá ser liberado com segurança.

Essa operação é permitida para o ouvinte no estado WS_LISTENER_STATE_OPEN ou WS_LISTENER_STATE_FAULTED . (Para estados de ouvinte, consulte a enumeração WS_LISTENER_STATE .)

Quando um ouvinte é fechado, todas as tentativas pendentes de aceitar um canal com o método WsAcceptChannel são anuladas. No entanto, WsCloseListener aguarda a conclusão de qualquer E/S pendente antes de prosseguir com o processo de fechamento.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho webservices.h
Biblioteca WebServices.lib
DLL WebServices.dll