Función WsCloseServiceProxy (webservices.h)

  • Artículo

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