Compartir a través de

Función WsOpenListener (webservices.h)

  • Artículo

Inicia la "escucha" en una dirección especificada. Una vez que se abre un agente de escucha, se pueden aceptar canales. Si la apertura se realiza correctamente, el agente de escucha debe cerrarse mediante la función WsCloseListener antes de que se puedan liberar los recursos del agente de escucha.

Sintaxis

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

Parámetros

[in] listener

Puntero al objeto Listener que se va a abrir. El puntero debe hacer referencia a un objeto WS_LISTENER válido y el valor al que se hace referencia no puede ser NULL.

[in] url

Puntero a un objeto que contiene la cadena de dirección URL del agente de escucha.

Nota La dirección URL siempre está en formato de escape. Es posible que la dirección URL no contenga una cadena de consulta o un fragmento. Esta dirección URL puede incluir los caracteres comodín "+" o "*" en la parte del nombre de host, o un nombre de host o una dirección IP literal. Consulte Comentarios para obtener más información sobre la dirección URL.
 

[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 agente de escucha se anuló durante la apertura o antes de la apertura.
WS_E_INVALID_OPERATION
 El agente de escucha está en estado incorrecto.
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

Al usar direcciones IPv6, deben ir entre corchetes en la parte del nombre de host.

Para obtener más información, consulte WS_HTTP_CHANNEL_BINDING.

Para WS_UDP_CHANNEL_BINDING, se omite la parte de ruta de acceso de la dirección URL. Si se especifica una dirección IP literal, se usa para escuchar; de lo contrario, se usa una dirección IP con caracteres comodín.

Para WS_TCP_CHANNEL_BINDING, la parte de la ruta de acceso de la dirección URL coincide como prefijo con la dirección URL recibida.
Si se especifica una dirección IP literal, se usa para escuchar; de lo contrario, se usa una dirección IP con caracteres comodín.

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