attribut endpoint
L’attribut [point de terminaison] spécifie un ou plusieurs ports connus (points de terminaison de communication) sur lesquels les serveurs de l’interface écoutent les appels.
endpoint("protocol-sequence:[endpoint-port]" [ , ...] )
Paramètres
-
séquence de protocole
-
Spécifie une chaîne de caractères qui représente une combinaison valide d’un protocole RPC (par exemple, « ncacn »), d’un protocole de transport (tel que « tcp ») et d’un protocole réseau (tel que « ip »). Pour obtenir la liste des séquences de protocoles valides, consultez Constantes de séquence de protocole.
-
point de terminaison-port
-
Spécifie une chaîne qui représente la désignation du point de terminaison pour la famille de protocoles spécifiée. La syntaxe de la chaîne de port est spécifique à chaque séquence de protocole.
Notes
L’attribut [point de terminaison] spécifie une famille de transport telle que le protocole orienté connexion TCP/IP, un protocole orienté connexion NetBIOS ou le protocole orienté connexion nommé. L’utilisation de l’attribut [point de terminaison] est cohérente avec d’autres méthodes d’ajout d’un point de terminaison et ne fournit pas de services supplémentaires ou spéciaux pour le point de terminaison ; il fournit simplement un raccourci pour appeler l’API.
Notes
Spécification d’un point de terminaison dans . La définition de l’interface IDL ne limite pas l’accès à l’interface au point de terminaison spécifié. Ajout d’un point de terminaison à . La définition de l’interface IDL permet à l’interface d’être appelée via n’importe quel point de terminaison de ce processus et permet d’utiliser le point de terminaison pour appeler d’autres interfaces dans ce processus.
La valeur de séquence de protocole détermine les valeurs valides pour le port de point de terminaison. Le compilateur MIDL vérifie uniquement la syntaxe générale pour l’entrée de port de point de terminaison . Les erreurs de spécification de port sont signalées par les bibliothèques d’exécution. Pour plus d’informations sur les valeurs autorisées pour chaque séquence de protocole, consultez constantes de séquence de protocole.
Les séquences de protocole suivantes spécifiées par DCE ne sont pas prises en charge par le compilateur MIDL fourni avec Microsoft RPC : ncacn_osi_dna et ncadg_dds.
Veillez à citer correctement les caractères de barre oblique inverse dans les points de terminaison. Cette erreur se produit généralement lorsque le point de terminaison est un canal nommé.
Les informations de point de terminaison spécifiées dans le fichier IDL sont utilisées par les fonctions d’exécution RPC RpcServerUseProtseqIf et RpcServerUseAllProtseqsIf.
Exemples
endpoint("ncacn_np:[\\pipe\\rainier]")
endpoint("ncacn_ip_tcp:[1044]", "ncacn_np:[\\pipe\\shasta]")
Voir aussi