Compartir a través de

Función WsOpenServiceHost (webservices.h)

  • Artículo

Abre un host de servicio para la comunicación e inicia los agentes de escucha en todos los puntos de conexión. Las aplicaciones cliente no se pueden conectar a los puntos de conexión de servicio hasta que se llame a WsOpenSerivceHost .

Sintaxis

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

Parámetros

[in] serviceHost

Puntero al objeto Host de servicio que se va a abrir. El puntero debe hacer referencia a un objeto WS_SERVICE_HOST válido devuelto por WsCreateServiceHost y el valor del host de servicio al que se hace referencia no puede ser NULL.

[in, optional] asyncContext

Puntero a un objeto WS_ASYNC_CONTEXT que tiene información sobre cómo invocar la función de forma asincrónica. El valor se establece en NULL si se invoca de forma sincrónica.

[in, optional] error

Puntero a un objeto WS_ERROR donde se debe almacenar información adicional sobre el error si se produce un error en la función.

Valor devuelto

Esta función puede devolver uno de estos valores.

Código devuelto Descripción
WS_S_ASYNC
 La operación asincrónica sigue pendiente.
WS_E_OPERATION_ABORTED
 El host de servicio se anuló antes de abrir o durante la apertura.
WS_E_INVALID_OPERATION
 El estado actual del proxy de servicio no es válido para esta operación.
WS_E_ADDRESS_IN_USE
 La dirección ya se está usando.
WS_E_ADDRESS_NOT_AVAILABLE
 La dirección no es válida para este contexto.
WS_E_QUOTA_EXCEEDED
 Se superó una cuota.
WS_E_OPERATION_ABORTED
 Se anuló la operación.
WS_E_OPERATION_TIMED_OUT
 La operación no se completó dentro del tiempo asignado.
E_OUTOFMEMORY
 Se quedó sin memoria.
E_INVALIDARG
 Uno o más argumentos no son válidos.
Otros errores
Esta función puede devolver otros errores no enumerados anteriormente.

Comentarios

Tenga en cuenta que todos los agentes de escucha de puntos de conexión tienen que abrirse correctamente antes de que el host de servicio acepte cualquier canal para comunicarse con el cliente.

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