Compartir a través de

Función WsCloseListener (webservices.h)

  • Artículo

Hace que el agente de escucha especificado deje de escuchar.

Sintaxis

HRESULT WsCloseListener(
  [in]           WS_LISTENER            *listener,
  [in, optional] const WS_ASYNC_CONTEXT *asyncContext,
  [in, optional] WS_ERROR               *error
);

Parámetros

[in] listener

Puntero a una estructura de WS_LISTENER que representa el agente de escucha 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_OPERATION_ABORTED
 El cierre se anuló mediante una llamada a WsAbortListener cuando el agente de escucha se estaba cerrando.
WS_E_INVALID_OPERATION
 El agente de escucha estaba en un estado inadecuado.
WS_E_OPERATION_TIMED_OUT
 La operación no se completó dentro del tiempo asignado.
E_INVALIDARG
 Uno o más argumentos no son válidos.
Otros errores
Esta función puede devolver otros errores no enumerados anteriormente.

Comentarios

Una vez cerrado el agente de escucha, el agente de escucha se puede liberar de forma segura.

Esta operación se permite para el agente de escucha en el estado WS_LISTENER_STATE_OPEN o WS_LISTENER_STATE_FAULTED . (Para los estados del agente de escucha, consulte la enumeración WS_LISTENER_STATE ).

Cuando se cierra un agente de escucha, se anulan los intentos pendientes de aceptar un canal con el método WsAcceptChannel . Sin embargo, WsCloseListener espera a que se complete cualquier E/S pendiente antes de continuar con el proceso de cierre.

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