sockaddr_atm structure (ws2atm.h)

Article
03/13/2024

La structure de sockaddr_atm Windows Sockets stocke les informations d’adresse de socket pour les sockets ATM.

Syntaxe

typedef struct sockaddr_atm {
  u_short     satm_family;
  ATM_ADDRESS satm_number;
  ATM_BLLI    satm_blli;
  ATM_BHLI    satm_bhli;
} sockaddr_atm, SOCKADDR_ATM, *PSOCKADDR_ATM, *LPSOCKADDR_ATM;

Membres

satm_family

Identifie la famille d’adresses, qui est AF_ATM dans ce cas.

satm_number

Identifie l’adresse atm qui peut être au format E.164 ou NSAP-style ATM End Systems Address. Ce champ est mappé à l’élément d’informations sur le numéro de partie (IE) appelé s’il est spécifié dans bind et WSPBind pour un socket d’écoute, ou dans connect, WSAConnect, WSPConnect, WSAJoinLeaf ou WSPJoinLeaf pour un socket de connexion. Il sera mappé au numéro de partie appelante IE s’il est spécifié dans bind et WSPBind pour un socket de connexion.

satm_blli

Identifie les champs de l’élément d’informations B-LLI qui sont utilisés avec satm_bhli pour identifier une application. Pour plus d’informations, consultez ATM_BLLI . Notez que les informations de la couche B-LLI 2 sont traitées comme non présentes si son champ Layer2Protocol contient SAP_FIELD_ABSENT, ou comme un caractère générique s’il contient SAP_FIELD_ANY. De même, les informations de la couche B-LLI 3 sont traitées comme non présentes si son champ Layer3Protocol contient SAP_FIELD_ABSENT, ou comme un caractère générique s’il contient SAP_FIELD_ANY.

satm_bhli

Identifie les champs dans l’élément d’informations B-HLI qui sont utilisés avec satm_blli pour identifier une application. Pour plus d’informations sur la structure ATM_BHLI, consultez ATM_BHLI .

Notezque satm_bhli est traité comme non présent si son champ HighLayerInfoType contient SAP_FIELD_ABSENT, ou comme un caractère générique s’il contient SAP_FIELD_ANY.

Remarques

Pour les sockets d’écoute, la structure sockaddr_atm est utilisée dans la liaison/WSPBind pour inscrire un point d’accès de service (SAP) afin de recevoir les demandes de connexion entrantes destinées à ce SAP. L’inscription SAP est utilisée pour établir une correspondance avec le SAP spécifié dans une demande de connexion entrante afin de déterminer quel socket d’écoute doit recevoir cette demande. Dans la spécification actuelle, l’inscription qui se chevauche n’est pas autorisée. L’inscription qui se chevauche est définie comme ayant plusieurs SAP inscrits pour correspondre potentiellement au SAP spécifié dans toute demande de connexion entrante. Listen et WSPListen retournent le code d’erreur WSAEADDRINUSE si le SAP associé au socket d’écoute chevauche les adresses SAP actuellement inscrites dans le système.

Les champs d’un SAP à inscrire doivent contenir une valeur valide ou l’une des deux constantes manifestes spéciales : SAP_FIELD_ABSENT ou SAP_FIELD_ANY.

SAP_FIELD_ABSENT signifie simplement que ce champ n’est pas présenté dans le cadre d’un SAP. SAP_FIELD_ANY signifie utiliser des caractères génériques.

Notez que l’exigence d’une inscription sans chevauchement n’empêche pas l’utilisation de caractères génériques. Par exemple, il est possible d’avoir deux SAP inscrites qui contiennent des SAP_FIELD_ANY dans certains champs et des valeurs différentes dans d’autres champs.

Note Le numéro atm de partie appelé étant obligatoire, le champ satm_number ne peut pas contenir SAP_FIELD_ABSENT.

Pour la connexion de sockets, la structure sockaddr_atm est utilisée pour spécifier le SAP de destination dans connecter/WSAConnect/WSPConnect pour les connexions point à point, et WSAJoinLeaf/WSPJoinLeaf pour les connexions point à multipoint. Les champs dans le SAP de destination d’un socket de connexion doivent contenir une valeur ou un SAP_FIELD_ABSENT valide, c’est-à-dire SAP_FIELD_ANY n’est pas autorisé.

En outre, SAP_FIELD_ABSENT n’est pas autorisé pour le champ satm_number . Le SAP de destination est utilisé pour effectuer une correspondance avec tous les SAP inscrits sur l’ordinateur de destination afin de déterminer la destination de transfert pour cette demande de connexion. Si chaque champ du SAP de destination d’une requête entrante est égal au champ correspondant d’un SAP inscrit ou que le champ correspondant contient le SAP_FIELD_ANY, le socket d’écoute associé à ce SAP inscrit reçoit la demande de connexion entrante.

Si bind et/ou WSPBind sont utilisés sur un socket de connexion pour spécifier l’adresse ATM de la partie appelante, les champs satm_blli et satm_bhli doivent être ignorés et ceux spécifiés dans connect, WSAConnect ou WSPConnect sont utilisés.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	ws2atm.h