Función WsCloseServiceProxy (webservices.h)

Cierra la comunicación con el proxy de servicio especificado.

Sintaxis

HRESULT WsCloseServiceProxy(
  [in]           WS_SERVICE_PROXY       *serviceProxy,
  [in, optional] const WS_ASYNC_CONTEXT *asyncContext,
  [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 cerrar.

[in, optional] asyncContext

Puntero a una estructura de WS_ASYNC_CONTEXT que contiene información para invocar la función de forma asincrónica. Pase NULL para invocar la función de forma sincrónica.

[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_S_ASYNC	La operación asincrónica sigue pendiente.
WS_E_INVALID_OPERATION	El estado actual del proxy de servicio no es válido para esta operación. Este es solo el error para el que se producirá un error de cierre.
WS_E_ENDPOINT_DISCONNECTED	El WS_CHANNEL subyacente se desconectó durante la operación de cierre. Este error solo se produce en los casos en los que el canal subyacente se basa en la sesión.
WS_E_OPERATION_ABORTED	Se anuló la operación.
WS_E_ENDPOINT_FAILURE	El punto de conexión remoto no pudo procesar la solicitud.
WS_E_INVALID_FORMAT	Los datos de entrada no tenían el formato esperado o no tenían el valor esperado.
WS_E_OPERATION_TIMED_OUT	La operación no se completó dentro del tiempo asignado.
WS_E_QUOTA_EXCEEDED	Se superó una cuota.
E_OUTOFMEMORY	Memoria insuficiente para completar la operación.
E_INVALIDARG	Uno o más argumentos no son válidos.
Otros errores	Esta función puede devolver otros errores no enumerados anteriormente.

Comentarios

Si hay una llamada de operación de servicio pendiente en el proxy de servicio, WsCloseServiceProxy espera a que se complete cada llamada. Después de llamar a la aplicación WsCloseServiceProxy no debe realizar más llamadas en el proxy de servicio.

Tenga en cuenta que WS_E_INVALID_OPERATION es el único
código de error que indica que se ha producido un error en el cierre. Otros códigos de error indican que la operación se realizó correctamente y que el código de error es solo para fines informativos.

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