Función WsOpenListener (webservices.h)
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.
[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 |
---|---|
|
La operación asincrónica sigue pendiente. |
|
El agente de escucha se anuló durante la apertura o antes de la apertura. |
|
El agente de escucha está en estado incorrecto. |
|
La dirección ya se está usando. |
|
La dirección no es válida para este contexto. |
|
Se superó una cuota. |
|
Se anuló la operación. |
|
La operación no se completó dentro del tiempo asignado. |
|
Se quedó sin memoria. |
|
Uno o más argumentos no son válidos. |
|
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 |