Función WsAbortServiceProxy (webservices.h)

  • Artículo

Anula el proxy de servicio y cancela cualquier E/S pendiente en el proxy de servicio.

Sintaxis

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

Parámetros

[in] serviceProxy

Puntero a una estructura de WS_SERVICE_PROXY que representa el proxy de servicio que se va a anular.

[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
E_INVALIDARG
 Uno o más argumentos no son válidos.

Comentarios

WsAbortServiceProxy muestra el siguiente comportamiento en función del estado del proxy de servicio (consulte la enumeración WS_SERVICE_PROXY_STATE para conocer los posibles estados):

  • Si el proxy de servicio está abriendo y en el estado WS_SERVICE_PROXY_STATE_OPENING, puede llamar a WsAbortServiceProxy para anular la operación de apertura. El proxy de servicio cancelará todas las E/S pendientes y volverá a pasar al estado WS_SERVICE_PROXY_STATE_CREATED.
  • Si el proxy de servicio ya está abierto y en el estado de WS_SERVICE_PROXY_STATE_OPEN, WsAbortServiceProxy hará que el proxy de servicio anule todos los canales subyacentes y pase al estado WS_SERVICE_PROXY_STATE_FAULTED. Una vez iniciada la anulación, el proxy de servicio no aceptará ninguna nueva llamada. La aplicación puede llamar a WsCloseServiceProxy para cerrarla.
  • Si el proxy de servicio se está cerrando y en el estado WS_SERVICE_PROXY_STATE_CLOSING, se anulan todos los canales subyacentes y el proxy de servicio pasa al estado WS_SERVICE_PROXY_STATE_CLOSED.

Para obtener un ejemplo de uso de esta función, consulte ServiceCancellationExample.

Requisitos

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