Compartir a través de

Función WsCreateChannelForListener (webservices.h)

  • Artículo

Crea un canal asociado a un agente de escucha especificado.

Sintaxis

HRESULT WsCreateChannelForListener(
  [in]           WS_LISTENER               *listener,
                 const WS_CHANNEL_PROPERTY *properties,
  [in]           ULONG                     propertyCount,
                 WS_CHANNEL                **channel,
  [in, optional] WS_ERROR                  *error
);

Parámetros

[in] listener

Puntero a una estructura de WS_LISTENER que representa el agente de escucha para el que se va a crear un canal. El agente de escucha puede estar en cualquier estado. (Para los estados del agente de escucha, consulte la enumeración WS_LISTENER_STATE ).

properties

Matriz de estructuras de WS_CHANNEL_PROPERTY que contienen valores opcionales para la inicialización del canal. Puede ser null, en cuyo caso, el parámetro propertyCount debe ser 0 (cero).

Para obtener información sobre cómo crear un canal personalizado, vea la sección Comentarios.

[in] propertyCount

Número de propiedades de la matriz de propiedades .

channel

Si se ejecuta correctamente, un puntero que recibe la dirección del canal creado.
Cuando el canal ya no sea necesario, debe liberarlo llamando a WsFreeChannel.

[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
E_INVALIDARG
 Uno o más argumentos no son válidos.
E_OUTOFMEMORY
 Memoria insuficiente para completar la operación.
Otros errores
Esta función puede devolver otros errores no enumerados anteriormente.

Comentarios

Para aceptar un intercambio de mensajes entrantes, llame a la función WsAcceptChannel .

Las características de seguridad del canal son las mismas que las especificadas para el agente de escucha.

Al crear un canal personalizado (mediante el valor WS_CUSTOM_CHANNEL_BINDING de la enumeración WS_CHANNEL_BINDING ), solo puede especificar las siguientes propiedades de canal:

  • WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_CALLBACKS
  • WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS
Si se requieren propiedades iniciales para crear el canal personalizado, especifíquelas mediante la propiedad WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS.

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