Compartir a través de

Función WsAbandonCall (webservices.h)

  • Artículo

Abandona una llamada especificada en el proxy de servicio especificado.

Sintaxis

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

Parámetros

[in] serviceProxy

Puntero a una estructura de WS_SERVICE_PROXY que representa el proxy de servicio en el que abandonar la llamada.

[in] callId

Identificador de la llamada que se va a abandonar. Vea la sección Comentarios.

[in, optional] error

Puntero a una estructura de WS_ERROR que recibe información de error adicional si se produce un error en la función.

Valor devuelto

Si la función se realiza correctamente, devuelve NO_ERROR; de lo contrario, devuelve un código de error HRESULT.

Código devuelto Descripción
WS_E_INVALID_OPERATION
 El estado actual del proxy de servicio no es válido para esta operación.
E_INVALIDARG
 Se pasó un proxy de servicio NULL a la función .

Comentarios

Las llamadas se identifican mediante un identificador de llamada. Este identificador de llamada está asociado a la llamada por el valor WS_CALL_PROPERTY_CALL_ID de la enumeración WS_CALL_PROPERTY_ID .

Si el identificador de llamada es 0, se abandonan todas las llamadas pendientes en el proxy de servicio. Para obtener más información, vea los temas siguientes:

Tenga en cuenta que la E/S real asociada a la llamada no se cancela. El proxy de servicio mantiene los recursos para completar la llamada aunque la llamada se abandonó.

Esto produce un consumo de recursos que se agrava si una aplicación sigue abandonando las llamadas, como puede ocurrir cuando el servidor es lento para responder al cliente y la aplicación cliente abandona una sola llamada para volver a realizar la misma llamada.

Requisitos

   
Cliente mínimo compatible Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado webservices.h
Library WebServices.lib
Archivo DLL WebServices.dll