Propriétés générales de canal

Le tableau suivant décrit les propriétés générales de canal et répertorie les types de canaux qui les prennent en charge.

Propriété	Description	Types qui prennent en charge cette propriété
name	Chaîne qui spécifie le nom de ce canal. Si vous ne spécifiez pas de nom, un nom par défaut, qui dépend du type, est utilisé : HttpChannel : « http »" HttpClientChannel : « http client » HttpServerChannel : « http server » TcpChannel : « tcp » TcpClientChannel : « tcp client » TcpServerChannel : « tcp server » IpcChannel : « ipc » IpcClientChannel : « ipc client » IpcServerChannel : « ipc server » Chaque canal doit avoir un nom unique. Donnez une valeur de chaîne vide (" " ou String.Empty) à cette propriété si vous souhaitez ignorer les noms, mais éviter les conflits d'attribution de noms. Vous pouvez affecter à la propriété name la valeur String.Empty pour le nombre de canaux souhaité. Cette propriété est utilisée pour récupérer un canal spécifique lors de l'appel de ChannelServices.GetChannel. Pour plus d'informations, consultez Canaux.	HttpChannel HttpServerChannel HttpClientChannel TcpChannel TcpClientChannel TcpServerChannel IpcChannel IpcClientChannel IpcServerChannel
machineName	Chaîne qui spécifie le nom de l'ordinateur utilisé avec le canal en cours. Si elle est utilisée avec un canal serveur, elle se substitue à useIpAddress. Remarque : Il est généralement recommandé d'utiliser le nom DNS (Domain Name System) de l'ordinateur, mais lorsque l'adresse IP d'une carte d'interface réseau particulière (habituellement une carte réseau sans fil) change rapidement, vous devez configurer l'application pour utiliser le machineName afin de permettre à l'accès distant de trouver l'ordinateur via DNS. Cependant, lorsque le nom de l'ordinateur n'est pas résolu assez rapidement (ou pas du tout) et lorsque l'ordinateur possède plusieurs cartes réseau, physiques ou virtuelles (cela est souvent le cas avec une connexion d'accès à distance ou une carte réseau VPN), vous devez affecter l'adresse IP de la carte réseau utilisée pour cette connexion à la propriété machineName.	HttpChannel HttpClientChannel HttpServerChannel TcpChannel TcpClientChannel TcpServerChannel
priority	Entier qui représente la priorité assignée au canal. Plus le nombre est élevé, plus le canal a de chances d'être sélectionné en premier. La priorité par défaut est 1 et les nombres négatifs sont autorisés.	HttpChannel HttpServerChannel HttpClientChannel TcpChannel TcpClientChannel TcpServerChannel IpcChannel IpcClientChannel IpcServerChannel
secure (TcpChannel)	Valeur Boolean (true ou false) qui spécifie si les communications sur le canal sont sécurisées. La valeur par défaut est false. Lorsque cette propriété a la valeur true, la propriété tokenImpersonationLevel a la valeur Identification et la propriété protectionLevel la valeur EncryptAndSign. Notez qu'un TcpClientChannel sécurisé ne peut se connecter qu'à un TcpServerChannel sécurisé, et un TcpClientChannel non sécurisé ne peut se connecter qu'à un TcpServerChannel non sécurisé. Remarque : Si le système d'exploitation du serveur est Windows 95/98/Millenium, il est impossible de spécifier le serveur TcpServerChannel comme étant sécurisé.	TcpChannel TcpClientChannel TcpServerChannel
secure (IpcChannel)	Valeur Boolean (true ou false) qui spécifie si les communications sur le canal sont sécurisées. La valeur par défaut est false. Lorsqu'elle a la valeur true, la propriété tokenImpersonationLevel prend la valeur Identification. Notez qu'un IpcClientChannel sécurisé peut se connecter à un IpcServerChannel sécurisé ou non sécurisé, mais un IpcClientChannel non sécurisé ne peut se connecter qu'à un IpcServerChannel non sécurisé.	IpcChannel IpcClientChannel IpcServerChannel
protectionLevel	Valeur de type ProtectionLevel. Par défaut, sa valeur est None, sauf si la propriété secure a la valeur true, auquel cas la valeur par défaut est EncryptAndSign. Vous devez définir la propriété secure à true pour pouvoir donner à la propriété ProtectionLevel une autre valeur que None. Notez que None est le seul paramètre qui est compatible avec Windows 95, Windows 98 et Windows Me.	TcpClientChannel TcpServerChannel

Voir aussi

Tâches

Comment : configurer un canal dans un fichier de configuration
Comment : configurer un canal par programme

Référence

Schéma des paramètres d'accès distant

Concepts

Configuration d'applications distantes
Configuration d'objets distants
Configuration d'objets distants

Copyright ©2007 par Microsoft Corporation. Tous droits réservés.