Compartilhar via

Função WsAbortChannel (webservices.h)

  • Artigo

Cancela todas as E/S pendentes para um canal especificado

Sintaxe

HRESULT WsAbortChannel(
  [in]           WS_CHANNEL *channel,
  [in, optional] WS_ERROR   *error
);

Parâmetros

[in] channel

Um ponteiro para uma estrutura WS_CHANNEL que representa o canal para o qual cancelar a E/S.

[in, optional] error

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

Valor retornado

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

Código de retorno Descrição
WS_E_NOT_SUPPORTED
 Consulte a seção Comentários para obter limitações de plataforma.
E_INVALIDARG
 Um ou mais argumentos são inválidos.

Comentários

Windows Server 2003 e antes: Em plataformas Windows antes do Windows Vista, essa função não terá suporte para WS_UDP_CHANNEL_BINDING ou WS_HTTP_CHANNEL_BINDING se o canal estiver no estado WS_CHANNEL_STATE_ACCEPTING e o ouvinte ainda não tiver sido anulado.

(Para obter informações sobre associações de canal e estados de canal, consulte as enumerações WS_CHANNEL_BINDING e WS_CHANNEL_STATE .)

Essa função também não tem suporte para WS_HTTP_CHANNEL_BINDING com WS_CHANNEL_TYPE_REPLY ao anular um canal no estado WS_CHANNEL_STATE_OPEN ou WS_CHANNEL_STATE_FAULTED. (Para obter informações sobre tipos de canal, consulte a enumeração WS_CHANNEL_TYPE .

WsAbortChannel pode ser chamado para um canal em qualquer estado e não aguarda a conclusão da E/S pendente antes de anular o canal.

Se o canal estiver no estado WS_CHANNEL_STATE_OPEN , WsAbortChannel fará com que o canal falha no estado WS_CHANNEL_STATE_FAULTED .

Nota Consulte WsAbandonMessage para obter informações sobre como ignorar uma mensagem específica e manter o canal aberto.

 
Se chamada com parâmetros válidos, essa função não falhará por motivos como a falta de recursos do sistema. No entanto, observe as limitações em algumas versões de sistemas operacionais no início do Comentário.

Requisitos

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