Compartilhar via

Função WsAbortServiceProxy (webservices.h)

  • Artigo

Anula o proxy de serviço e cancela qualquer E/S pendente no proxy de serviço.

Sintaxe

HRESULT WsAbortServiceProxy(
  [in]           WS_SERVICE_PROXY *serviceProxy,
  [in, optional] WS_ERROR         *error
);

Parâmetros

[in] serviceProxy

Ponteiro para uma estrutura WS_SERVICE_PROXY que representa o proxy de serviço a ser anulado.

[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
E_INVALIDARG
 Um ou mais argumentos são inválidos.

Comentários

WsAbortServiceProxy mostra o seguinte comportamento dependendo do estado do proxy de serviço (consulte a enumeração WS_SERVICE_PROXY_STATE para possíveis estados):

  • Se o proxy de serviço estiver abrindo e no estado WS_SERVICE_PROXY_STATE_OPENING, você poderá chamar WsAbortServiceProxy para anular a operação de abertura. O proxy de serviço cancelará toda a E/S pendente e fará a transição de volta para WS_SERVICE_PROXY_STATE_CREATED estado.
  • Se o proxy de serviço já estiver aberto e no estado WS_SERVICE_PROXY_STATE_OPEN, WsAbortServiceProxy fará com que o proxy de serviço anule todos os canais subjacentes e faça a transição para o estado WS_SERVICE_PROXY_STATE_FAULTED. Depois que a anulação for iniciada, o proxy de serviço não aceitará novas chamadas. O aplicativo pode chamar WsCloseServiceProxy para fechá-lo
  • Se o proxy de serviço estiver fechando e no estado WS_SERVICE_PROXY_STATE_CLOSING, todos os canais subjacentes serão anulados e o proxy de serviço fará a transição para o estado WS_SERVICE_PROXY_STATE_CLOSED.

Para obter um exemplo de como usar essa função, consulte ServiceCancellationExample.

Requisitos

Requisito Valor
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