Channel (Windows Web Services)

Les canaux encapsulent un contexte de communication entre deux ou plusieurs parties et sont utilisés pour envoyer et recevoir des messages.

Sur le client, utilisez WsCreateChannel pour créer un canal. Sur le serveur, utilisez WsCreateChannelForListener pour créer un canal qui peut être accepté par le client à l’aide d’un écouteur.

Lorsque vous créez un canal, vous spécifiez les informations suivantes, qui déterminent à la fois le comportement local du canal et le protocole de transmission à utiliser.

• Un WS_CHANNEL_TYPE, qui identifie le modèle d’échange de messages du canal.
• Un WS_CHANNEL_BINDING, qui identifie le protocole de transfert à utiliser.
• Un WS_SECURITY_DESCRIPTION, qui spécifie la sécurité utilisée pour le canal. Lors de la création de canaux à utiliser dans un serveur, cela est spécifié une fois pour tous les canaux qui seront acceptés pour un écouteur donné.
• Ensemble WS_CHANNEL_PROPERTYqui spécifient des paramètres facultatifs supplémentaires (pour obtenir la liste de ces paramètres, consultez les énumérations WS_CHANNEL_PROPERTY_ID ).

Avant d’utiliser le canal, vous devez l’ouvrir en appelant la fonction WsOpenChannel et en spécifiant le canal et l’adresse du point de terminaison, ainsi que d’autres informations facultatives.

Pour plus d’informations sur les transitions d’état pour un canal, consultez la rubrique États de canal .

Pour plus d’informations sur les canaux, consultez la rubrique Vue d’ensemble de la couche de canal.

Les éléments d’API suivants sont utilisés avec les canaux.

Rappel	Description
WS_ABANDON_MESSAGE_CALLBACK	Gère l’appel WsAbandonMessage pour un canal avec liaison de canal personnalisée.
WS_ABORT_CHANNEL_CALLBACK	Gère l’appel WsAbortChannel pour un canal avec liaison de canal personnalisée.
WS_CLOSE_CHANNEL_CALLBACK	Gère l’appel WsCloseChannel pour un canal avec liaison de canal personnalisée.
WS_CREATE_CHANNEL_CALLBACK	Gère l’appel WsCloseChannel pour un canal avec liaison de canal personnalisée.
WS_CREATE_DECODER_CALLBACK	Gère la création d’un décodeur instance.
WS_CREATE_ENCODER_CALLBACK	Gère la création d’un instance d’encodeur.
WS_DECODER_DECODE_CALLBACK	Décode un message.
WS_DECODER_END_CALLBACK	Décode la fin d’un message.
WS_DECODER_GET_CONTENT_TYPE_CALLBACK	Obtient le type de contenu du message.
WS_DECODER_START_CALLBACK	Démarre le décodage d’un message.
WS_ENCODER_ENCODE_CALLBACK	Encode un message.
WS_ENCODER_END_CALLBACK	Encode la fin d’un message.
WS_ENCODER_GET_CONTENT_TYPE_CALLBACK	Obtient le type de contenu du message.
WS_ENCODER_START_CALLBACK	Démarre l’encodage d’un message.
WS_FREE_CHANNEL_CALLBACK	Gère l’appel WsFreeChannel pour un canal avec liaison de canal personnalisée.
WS_FREE_DECODER_CALLBACK	Gère la libération d’un décodeur instance.
WS_FREE_ENCODER_CALLBACK	Gère la libération d’un encodeur instance.
WS_GET_CHANNEL_PROPERTY_CALLBACK	Gère l’appel WsGetChannelProperty pour un canal avec liaison de canal personnalisée.
WS_HTTP_REDIRECT_CALLBACK	Appelé lorsqu’un message est sur le point d’être automatiquement redirigé vers un autre service utilisant la fonctionnalité de redirection automatique HTTP, comme décrit dans RFC2616.
WS_OPEN_CHANNEL_CALLBACK	Gère l’appel WsOpenChannel pour un canal avec une liaison de canal personnalisée.
WS_READ_MESSAGE_END_CALLBACK	Gère l’appel WsReadMessageEnd pour un canal avec liaison de canal personnalisée.
WS_READ_MESSAGE_START_CALLBACK	Gère l’appel WsReadMessageEnd pour un canal avec liaison de canal personnalisée.
WS_RESET_CHANNEL_CALLBACK	Gère l’appel WsResetChannel pour un canal avec liaison de canal personnalisée.
WS_SET_CHANNEL_PROPERTY_CALLBACK	Gère l’appel WsSetChannelProperty pour un canal avec liaison de canal personnalisée.
WS_SHUTDOWN_SESSION_CHANNEL_CALLBACK	Gère l’appel WsShutdownSessionChannel pour un canal avec liaison de canal personnalisée.
WS_WRITE_MESSAGE_END_CALLBACK	Gère l’appel WsWriteMessageEnd pour un canal avec liaison de canal personnalisée.
WS_WRITE_MESSAGE_START_CALLBACK	Gère l’appel WsWriteMessageStart pour un canal avec liaison de canal personnalisée.

 

Énumération	Description
WS_CHANNEL_BINDING	Indique la pile de protocoles à utiliser pour le canal.
WS_CHANNEL_PROPERTY_ID	Identifie chaque propriété de canal par un ID.
WS_CHANNEL_STATE	État du canal.
WS_CHANNEL_TYPE	Indique les caractéristiques de base du canal, par exemple s’il est de session et quelles directions de communication sont prises en charge.
WS_ENCODING	Les différents encodages (formats de message).
WS_RECEIVE_OPTION	Spécifie si un message est requis lors de la réception à partir d’un canal.
WS_TRANSFER_MODE	Spécifie si les messages envoyés ou reçus sont diffusés en continu ou mis en mémoire tampon.

 

Fonction	Description
WsAbandonMessage	Ignore le reste d’un message pour un canal.
WsAbortChannel	Abandonne toutes les E/S en attente sur un canal spécifié et définit l’état du canal sur WS_CHANNEL_STATE_FAULTED.
WsCloseChannel	Ferme un canal lorsqu’il n’est plus nécessaire.
WsCreateChannel	Crée un canal.
WsCreateChannelForListener	Crée un canal pour un écouteur.
WsFreeChannel	Libère les ressources de mémoire associées à un canal.
WsGetChannelProperty	Récupère une propriété du canal référencée par le paramètre channel.
WsOpenChannel	Ouvre un canal à un point de terminaison.
WsReadMessageEnd	Lit les éléments fermants d’un message à partir d’un canal.
WsReadMessageStart	Lit les en-têtes du message suivant à partir du canal et se prépare à lire les éléments du corps.
WsReceiveMessage	Reçoit un message et désérialise le corps du message en tant que valeur.
WsRequestReply	Envoie un message de demande et reçoit un message de réponse corrélé.
WsResetChannel	Réinitialisez un canal afin qu’il puisse être réutilisé.
WsSendMessage	Envoie un message sur un canal à l’aide de la sérialisation pour écrire l’élément body.
WsSendReplyMessage	Envoie un message qui est une réponse à un message reçu.
WsSetChannelProperty	Définit une propriété d’un canal.
WsSetMessageProperty	Définit une propriété d’un message.
WsWriteMessageEnd	Écrit les éléments fermants d’un message dans le canal.
WsWriteMessageStart	Écrivez les en-têtes d’un message dans le canal et préparez-vous à écrire les éléments du corps.

 

Handle	Description
WS_CHANNEL	Type opaque utilisé pour référencer un canal.

 

Structure	Description
WS_CHANNEL_DECODER	Ensemble de rappels qui transforment le type de contenu et les octets encodés d’un message reçu.
WS_CHANNEL_ENCODER	Ensemble de rappels qui peuvent transformer le type de contenu et les octets encodés d’un message envoyé.
WS_CHANNEL_PROPERTIES	Ensemble de structures WS_CHANNEL_PROPERTY .
WS_CHANNEL_PROPERTY	Paramètre spécifique au canal.
WS_CUSTOM_CHANNEL_CALLBACKS	Ensemble de rappels qui forment l’implémentation d’un canal personnalisé.
WS_CUSTOM_HTTP_PROXY	permet de spécifier le proxy personnalisé pour le canal, à l’aide de la valeur WS_CHANNEL_PROPERTY_CUSTOM_HTTP_PROXY de l’énumération WS_CHANNEL_PROPERTY_ID .
WS_HTTP_HEADER_MAPPING	Représente un en-tête individuel mappé dans le cadre de WS_HTTP_MESSAGE_MAPPING.
WS_HTTP_MESSAGE_MAPPING	Informations sur la façon dont une requête ou une réponse HTTP doit être représentée dans un objet message.
WS_HTTP_REDIRECT_CALLBACK_CONTEXT	Spécifie la fonction de rappel et l’état pour contrôler le comportement de redirection automatique HTTP.
WS_MESSAGE_DESCRIPTION	Schéma des WS_MESSAGE d’entrée et de sortie pour une description d’opération donnée.