Función WsAbandonCall (webservices.h)

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.

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:

• Operaciones de servicio del lado cliente
• CallAbandonExample

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