Compartilhar via

Função WsAbandonCall (webservices.h)

  • Artigo

Abandona uma chamada especificada no proxy de serviço especificado.

Sintaxe

HRESULT WsAbandonCall(
  [in]           WS_SERVICE_PROXY *serviceProxy,
  [in]           ULONG            callId,
  [in, optional] WS_ERROR         *error
);

Parâmetros

[in] serviceProxy

Ponteiro para uma estrutura WS_SERVICE_PROXY que representa o proxy de serviço no qual abandonar a chamada.

[in] callId

ID da chamada para abandonar. (Consulte a seção Comentários.)

[in, optional] error

Ponteiro para uma estrutura 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 retornará um código de erro HRESULT.

Código de retorno Descrição
WS_E_INVALID_OPERATION
 O estado atual do proxy de serviço não é válido para esta operação.
E_INVALIDARG
 Um proxy de serviço NULL foi passado para a função .

Comentários

As chamadas são identificadas por uma ID de chamada. Essa ID de chamada é associada à chamada pelo valor WS_CALL_PROPERTY_CALL_ID da enumeração WS_CALL_PROPERTY_ID .

Se a ID da chamada for 0, todas as chamadas pendentes no proxy de serviço serão abandonadas. Para obter mais informações, consulte estes tópicos:

Lembre-se de que a E/S real associada à chamada não foi cancelada. O proxy de serviço mantém os recursos para concluir a chamada, mesmo que a chamada tenha sido abandonada.

Isso resulta em um consumo de recursos que será agravado se um aplicativo continuar a abandonar chamadas, como pode acontecer quando o servidor está lento para responder ao cliente e o aplicativo cliente abandona uma chamada apenas para fazer a mesma chamada novamente.

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