Compartir a través de

Función WsCloseServiceHost (webservices.h)

  • Artículo

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

Sintaxis

HRESULT WsCloseServiceHost(
  [in]           WS_SERVICE_HOST        *serviceHost,
  [in, optional] const WS_ASYNC_CONTEXT *asyncContext,
  [in, optional] WS_ERROR               *error
);

Parámetros

[in] serviceHost

Puntero a una estructura de WS_SERVICE_HOST que representa el host 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 host de servicio no es válido para esta operación.
E_INVALIDARG
 Uno o más argumentos no son válidos.
WS_E_OPERATION_TIMED_OUT
 La operación no se completó dentro del tiempo asignado.
WS_E_OPERATION_ABORTED
 Se anuló la operación.
Otros errores
Esta función puede devolver otros errores no enumerados anteriormente.

Comentarios

WsCloseServiceHost cierra todos los agentes de escucha en el host de servicio. Como resultado, no se aceptan nuevos canales del cliente. Sin embargo, la E/S pendiente en los canales ya aceptados puede completarse.

Esto tiene implicaciones para los puntos de conexión configurados para ejecutarse con enlaces de canal basados en sesión. Si un cliente tiene una sesión abierta con un servicio en este punto de conexión, el cierre no se completará hasta que el cliente cierre la sesión con el servicio.

Requisitos

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