Função WsAbortListener (webservices.h)

Cancela qualquer E/S pendente para o ouvinte especificado.

Sintaxe

HRESULT WsAbortListener(
  [in]           WS_LISTENER *listener,
  [in, optional] WS_ERROR    *error
);

Parâmetros

[in] listener

Ponteiro para uma estrutura WS_LISTENER que representa o ouvinte para o qual cancelar a E/S.

[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.

Comentários

WsAbortListener pode ser chamado quando o ouvinte está em qualquer estado. (Consulte a enumeração WS_LISTENER_STATE para possíveis estados.) Se o ouvinte estiver no estado WS_LISTENER_STATE_OPEN, essa função forçará o ouvinte a falhar (redefinir para o estado WS_LISTENER_STATE_FAULTED). Quando um ouvinte tem falha, todas as tentativas de aceitar uma mensagem dele falham imediatamente com o código de erro WS_E_OBJECT_FAULTED.

Essa função não aguarda a conclusão da E/S pendente.

Se chamado com parâmetros válidos, essa função não falhará por motivos como a falta de recursos do sistema.

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