Canal (servicios web de Windows)
Los canales encapsulan un contexto de comunicación entre dos o más partes y se usan para enviar y recibir mensajes.
En el cliente, use WsCreateChannel para crear un canal. En el servidor, use WsCreateChannelForListener para crear un canal que el cliente pueda aceptar mediante un agente de escucha.
Cuando se crea un canal, se especifica la siguiente información, que determina el comportamiento local del canal y el protocolo de conexión que se va a usar.
- Un WS_CHANNEL_TYPE, que identifica el patrón de intercambio de mensajes del canal.
- Un WS_CHANNEL_BINDING, que identifica el protocolo de transferencia que se va a usar.
- Un WS_SECURITY_DESCRIPTION, que especifica la seguridad usada para el canal. Al crear canales para su uso en un servidor, se especifica una vez para todos los canales que se aceptarán para un agente de escucha determinado.
- Un conjunto WS_CHANNEL_PROPERTYs, que especifica opciones opcionales adicionales (para obtener una lista de estos valores, vea las enumeraciones WS_CHANNEL_PROPERTY_ID ).
Antes de usar el canal, debe abrirlo llamando a la función WsOpenChannel y especificando el canal y la dirección del punto de conexión, junto con otra información opcional.
Para obtener información sobre las transiciones de estado de un canal, consulte el tema Estados del canal .
Para obtener más información sobre los canales, consulte el tema Información general sobre la capa de canal .
Los siguientes elementos de API se usan con canales.
| Devolución de llamada | Descripción |
|---|---|
| WS_ABANDON_MESSAGE_CALLBACK | Controla la llamada WsAbandonMessage para un canal con enlace de canal personalizado. |
| WS_ABORT_CHANNEL_CALLBACK | Controla la llamada WsAbortChannel para un canal con enlace de canal personalizado. |
| WS_CLOSE_CHANNEL_CALLBACK | Controla la llamada de WsCloseChannel para un canal con enlace de canal personalizado. |
| WS_CREATE_CHANNEL_CALLBACK | Controla la llamada de WsCloseChannel para un canal con enlace de canal personalizado. |
| WS_CREATE_DECODER_CALLBACK | Controla la creación de una instancia de descodificador. |
| WS_CREATE_ENCODER_CALLBACK | Controla la creación de una instancia de codificador. |
| WS_DECODER_DECODE_CALLBACK | Descodifica un mensaje. |
| WS_DECODER_END_CALLBACK | Descodifica el final de un mensaje. |
| WS_DECODER_GET_CONTENT_TYPE_CALLBACK | Obtiene el tipo de contenido del mensaje. |
| WS_DECODER_START_CALLBACK | Inicia la descodificación de un mensaje. |
| WS_ENCODER_ENCODE_CALLBACK | Codifica un mensaje. |
| WS_ENCODER_END_CALLBACK | Codifica el final de un mensaje. |
| WS_ENCODER_GET_CONTENT_TYPE_CALLBACK | Obtiene el tipo de contenido del mensaje. |
| WS_ENCODER_START_CALLBACK | Inicia la codificación de un mensaje. |
| WS_FREE_CHANNEL_CALLBACK | Controla la llamada de WsFreeChannel para un canal con enlace de canal personalizado. |
| WS_FREE_DECODER_CALLBACK | Controla la liberación de una instancia de descodificador. |
| WS_FREE_ENCODER_CALLBACK | Controla la liberación de una instancia de codificador. |
| WS_GET_CHANNEL_PROPERTY_CALLBACK | Controla la llamada de WsGetChannelProperty para un canal con enlace de canal personalizado. |
| WS_HTTP_REDIRECT_CALLBACK | Se invoca cuando un mensaje está a punto de redirigirse automáticamente a otro servicio mediante la funcionalidad de redirección automática HTTP, como se describe en RFC2616. |
| WS_OPEN_CHANNEL_CALLBACK | Controla la llamada de WsOpenChannel para un canal con enlace de canal personalizado. |
| WS_READ_MESSAGE_END_CALLBACK | Controla la llamada WsReadMessageEnd para un canal con enlace de canal personalizado. |
| WS_READ_MESSAGE_START_CALLBACK | Controla la llamada WsReadMessageEnd para un canal con enlace de canal personalizado. |
| WS_RESET_CHANNEL_CALLBACK | Controla la llamada de WsResetChannel para un canal con enlace de canal personalizado. |
| WS_SET_CHANNEL_PROPERTY_CALLBACK | Controla la llamada WsSetChannelProperty para un canal con enlace de canal personalizado. |
| WS_SHUTDOWN_SESSION_CHANNEL_CALLBACK | Controla la llamada de WsShutdownSessionChannel para un canal con enlace de canal personalizado. |
| WS_WRITE_MESSAGE_END_CALLBACK | Controla la llamada WsWriteMessageEnd para un canal con enlace de canal personalizado. |
| WS_WRITE_MESSAGE_START_CALLBACK | Controla la llamada WsWriteMessageStart para un canal con enlace de canal personalizado. |
| Enumeración | Descripción |
|---|---|
| WS_CHANNEL_BINDING | Indica la pila de protocolos que se va a usar para el canal. |
| WS_CHANNEL_PROPERTY_ID | Identifica cada propiedad de canal por un identificador. |
| WS_CHANNEL_STATE | Estado del canal. |
| WS_CHANNEL_TYPE | Indica las características básicas del canal, como si es con sesión y qué direcciones de comunicación se admiten. |
| WS_ENCODING | Las diferentes codificaciones (formatos de mensaje). |
| WS_RECEIVE_OPTION | Especifica si se requiere un mensaje al recibir desde un canal. |
| WS_TRANSFER_MODE | Especifica si los mensajes enviados o recibidos se transmiten o almacenan en búfer. |
| Función | Descripción |
|---|---|
| WsAbandonMessage | Omite el resto de un mensaje para un canal. |
| WsAbortChannel | Anula todas las E/S pendientes en un canal especificado y establece el estado del canal en WS_CHANNEL_STATE_FAULTED. |
| WsCloseChannel | Cierra un canal cuando ya no es necesario. |
| WsCreateChannel | Crea un canal. |
| WsCreateChannelForListener | Crea un canal para un agente de escucha. |
| WsFreeChannel | Libera los recursos de memoria asociados a un canal. |
| WsGetChannelProperty | Recupera una propiedad del canal al que hace referencia el parámetro channel. |
| WsOpenChannel | Abre un canal en un punto de conexión. |
| WsReadMessageEnd | Lee los elementos de cierre de un mensaje de un canal. |
| WsReadMessageStart | Lee los encabezados del siguiente mensaje del canal y se prepara para leer los elementos del cuerpo. |
| WsReceiveMessage | Recibe un mensaje y deserializa el cuerpo del mensaje como un valor. |
| WsRequestReply | Envía un mensaje de solicitud y recibe un mensaje de respuesta correlacionado. |
| WsResetChannel | Restablezca un canal para que se pueda reutilizar. |
| WsSendMessage | Envía un mensaje en un canal mediante la serialización para escribir el elemento body. |
| WsSendReplyMessage | Envía un mensaje que es una respuesta a un mensaje recibido. |
| WsSetChannelProperty | Establece una propiedad de un canal. |
| WsSetMessageProperty | Establece una propiedad de un mensaje. |
| WsWriteMessageEnd | Escribe los elementos de cierre de un mensaje en el canal. |
| WsWriteMessageStart | Escriba los encabezados de un mensaje en el canal y se prepare para escribir los elementos del cuerpo. |
| Handle | Descripción |
|---|---|
| WS_CHANNEL | Tipo opaco que se usa para hacer referencia a un canal. |
| Estructura | Descripción |
|---|---|
| WS_CHANNEL_DECODER | Conjunto de devoluciones de llamada que transforman el tipo de contenido y los bytes codificados de un mensaje recibido. |
| WS_CHANNEL_ENCODER | Conjunto de devoluciones de llamada que pueden transformar el tipo de contenido y los bytes codificados de un mensaje enviado. |
| WS_CHANNEL_PROPERTIES | Un conjunto de estructuras de WS_CHANNEL_PROPERTY . |
| WS_CHANNEL_PROPERTY | Una configuración específica del canal. |
| WS_CUSTOM_CHANNEL_CALLBACKS | Conjunto de devoluciones de llamada que forman la implementación de un canal personalizado. |
| WS_CUSTOM_HTTP_PROXY | se usa para especificar el proxy personalizado para el canal, utilizando el valor WS_CHANNEL_PROPERTY_CUSTOM_HTTP_PROXY de la enumeración WS_CHANNEL_PROPERTY_ID . |
| WS_HTTP_HEADER_MAPPING | Representa un encabezado individual que se asigna como parte de WS_HTTP_MESSAGE_MAPPING. |
| WS_HTTP_MESSAGE_MAPPING | Información sobre cómo se debe representar una solicitud o respuesta HTTP en un objeto de mensaje. |
| WS_HTTP_REDIRECT_CALLBACK_CONTEXT | Especifica la función de devolución de llamada y el estado para controlar el comportamiento de redireccionamiento automático HTTP. |
| WS_MESSAGE_DESCRIPTION | Esquema de la entrada y salida WS_MESSAGE para una descripción de operación determinada. |