canal (Services Web Windows)

Les canaux encapsulent un contexte de communication entre deux ou plusieurs tiers 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 câble à utiliser.

  • Type de _ canal _ WSqui identifie le modèle d’échange de messages du canal.
  • Une _ _ liaison WS Channel, qui identifie le protocole de transfert à utiliser.
  • Description de la _ _ sécurité WS, qui spécifie la sécurité utilisée pour le canal. Lors de la création de canaux à utiliser sur un serveur, cela est spécifié une fois pour tous les canaux qui seront acceptés pour un écouteur donné.
  • Un ensemble de _ _ Propriétés WS Channel, qui spécifient des paramètres facultatifs supplémentaires (pour obtenir la liste de ces paramètres, consultez énumérations de l' _ _ _ ID de propriété du canal WS ).

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 d’un canal, consultez la rubrique États du 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
_rappel de _ message WS abandon _ Gère l’appel WsAbandonMessage pour un canal avec une liaison de canal personnalisée.
_rappel de _ canal WS Abort _ Gère l’appel WsAbortChannel pour un canal avec une liaison de canal personnalisée.
_rappel de _ canal WS Close _ Gère l’appel WsCloseChannel pour un canal avec une liaison de canal personnalisée.
_rappel de canal WS Create _ _ Gère l’appel WsCloseChannel pour un canal avec une liaison de canal personnalisée.
création d’un _ _ rappel de décodeur WS _ Gère la création d’une instance de décodeur.
création d’un _ _ rappel d’encodeur WS _ Gère la création d’une instance d’encodeur.
rappel du décodeur WS _ _ _ Décode un message.
_rappel de fin du DÉcodeur WS _ _ Décode la fin d’un message.
le _ DÉcodeur WS _ obtient le rappel de _ type de contenu _ _ Obtient le type de contenu du message.
_rappel de démarrage du DÉcodeur WS _ _ Démarre le décodage d’un message.
rappel de codage de code d' _ encodeur WS _ _ Encode un message.
rappel de fin de l' _ encodeur WS _ _ Encode la fin d’un message.
_rappel du _ _ type de _ contenu _ de l’encodeur WS Obtient le type de contenu du message.
rappel de début de l' _ encodeur WS _ _ Démarre l’encodage d’un message.
_rappel de _ canal _ libre WS Gère l’appel WsFreeChannel pour un canal avec une liaison de canal personnalisée.
_rappel du _ décodeur _ libre WS Gère la libération d’une instance de décodeur.
rappel de l' _ _ encodeur libre WS _ Gère la libération d’une instance d’encodeur.
le _ rappel de la _ propriété de canal _ _ WS Gère l’appel WsGetChannelProperty pour un canal avec une liaison de canal personnalisée.
_rappel de _ redirection WS http _ Appelé lorsqu’un message va être automatiquement redirigé vers un autre service à l’aide de la fonctionnalité de redirection automatique HTTP, comme décrit dans RFC2616.
_rappel de _ canal WS Open _ Gère l’appel WsOpenChannel pour un canal avec une liaison de canal personnalisée.
_rappel de _ fin de message WS Read _ _ Gère l’appel WsReadMessageEnd pour un canal avec une liaison de canal personnalisée.
_rappel de _ démarrage du message WS Read _ _ Gère l’appel WsReadMessageEnd pour un canal avec une liaison de canal personnalisée.
_rappel de _ canal WS Reset _ Gère l’appel WsResetChannel pour un canal avec une liaison de canal personnalisée.
_rappel de _ propriété de canal WS Set _ _ Gère l’appel WsSetChannelProperty pour un canal avec une liaison de canal personnalisée.
_rappel de _ canal de session d’arrêt WS _ _ Gère l’appel WsShutdownSessionChannel pour un canal avec une liaison de canal personnalisée.
_rappel de _ fin de message WS Write _ _ Gère l’appel WsWriteMessageEnd pour un canal avec une liaison de canal personnalisée.
_rappel de _ démarrage du message WS Write _ _ Gère l’appel WsWriteMessageStart pour un canal avec une liaison de canal personnalisée.
Énumération Description
_liaison WS Channel _ Indique la pile de protocole à utiliser pour le canal.
_ID de _ propriété du canal WS _ Identifie chaque propriété de canal par un ID.
_État du canal WS _ État du canal.
_type de canal WS _ Indique les caractéristiques de base du canal, par exemple s’il s’agit d’une session et quelles directions de communication sont prises en charge.
_codage WS Les différents encodages (formats de message).
_option WS Receive _ Spécifie si un message est requis lors de la réception d’un canal.
_mode WS Transfer _ 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 mémoire associées à un canal.
WsGetChannelProperty Récupère une propriété du canal référencé par le paramètre de canal.
WsOpenChannel Ouvre un canal à un point de terminaison.
WsReadMessageEnd Lit les éléments de fermeture d’un message à partir d’un canal.
WsReadMessageStart Lit les en-têtes du message suivant à partir du canal et prépare la lecture des é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éinitialiser 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 la propriété d’un message.
WsWriteMessageEnd Écrit les éléments de fermeture d’un message dans le canal.
WsWriteMessageStart Écrit les en-têtes d’un message dans le canal et prépare l’écriture des éléments du corps.
Handle Description
_canal WS Type opaque utilisé pour référencer un canal.
Structure Description
_DÉcodeur WS Channel _ Ensemble de rappels qui transforment le type de contenu et les octets encodés d’un message reçu.
_encodeur WS Channel _ Ensemble de rappels qui peuvent transformer le type de contenu et les octets encodés d’un message envoyé.
_Propriétés du canal WS _ Ensemble de structures de _ _ propriété WS Channel .
_propriété WS Channel _ Paramètre spécifique au canal.
_ _ rappels de canal personnalisé WS _ Ensemble de rappels qui forment l’implémentation d’un canal personnalisé.
_ _ proxy HTTP personnalisé _ WS utilisé pour spécifier le proxy personnalisé pour le canal, à l’aide de la propriété WS Channel valeur de proxy _ _ _ _ http personnalisée _ de l’énumération d' _ ID de _ propriété _ WS Channel .
_mappage d' _ en-tête WS http _ Représente un en-tête individuel qui est mappé dans le cadre du _ _ _ mappage de message http WS.
_mappage de _ message WS http _ Informations sur la façon dont une requête ou une réponse HTTP doit être représentée dans un objet de message.
_contexte de _ rappel de redirection WS http _ _ Spécifie la fonction de rappel et l’État pour contrôler le comportement de redirection automatique HTTP.
_Description du message WS _ Schéma pour le _ message WS d’entrée et de sortie pour une description d’opération donnée.