sockaddr_atm-Struktur (ws2atm.h)

Artikel
03/13/2024

Die Struktur Windows Sockets sockaddr_atm speichert Socketadresseninformationen für ATM-Sockets.

Syntax

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;

Member

satm_family

Gibt die Adressfamilie an, die in diesem Fall AF_ATM ist.

satm_number

Gibt die Atm-Adresse an, die entweder im E.164- oder NSAP-Format für ATM-Endsystemadressen sein könnte. Dieses Feld wird dem aufgerufenen Party Number Information Element (IE) zugeordnet, wenn es in bind und WSPBind für einen Abhörsocket oder in connect, WSAConnect, WSPConnect, WSAJoinLeaf oder WSPJoinLeaf für einen Verbindungssocket angegeben wird. Sie wird der Anrufernummer IE zugeordnet, wenn sie in bind und WSPBind für einen Verbindungssocket angegeben ist.

satm_blli

Identifiziert die Felder im B-LLI-Informationselement, die zusammen mit satm_bhli zum Identifizieren einer Anwendung verwendet werden. Weitere Informationen finden Sie unter ATM_BLLI . Beachten Sie, dass die Informationen der 2. B-LLI-Ebene als nicht vorhanden behandelt werden, wenn ihr Layer2Protocol-Feld SAP_FIELD_ABSENT enthält, oder als Platzhalter, wenn es SAP_FIELD_ANY enthält. Auf ähnliche Weise werden die Informationen der B-LLI-Ebene als nicht vorhanden behandelt, wenn ihr Layer3Protocol-Feld SAP_FIELD_ABSENT enthält, oder als Platzhalter, wenn es SAP_FIELD_ANY enthält.

satm_bhli

Identifiziert die Felder im B-HLI-Informationselement, die zusammen mit satm_blli zum Identifizieren einer Anwendung verwendet werden. Weitere Informationen zur ATM_BHLI-Struktur finden Sie unter ATM_BHLI .

Beachten Siesatm_bhli als nicht vorhanden behandelt wird, wenn das Feld HighLayerInfoType SAP_FIELD_ABSENT enthält, oder als Platzhalter, wenn es SAP_FIELD_ANY enthält.

Hinweise

Für lauschende Sockets wird die sockaddr_atm-Struktur inBindungs-WSPBind / verwendet, um einen Service Access Point (SAP) zu registrieren, um eingehende Verbindungsanforderungen zu empfangen, die an diese SAP-Instanz bestimmt sind. Die SAP-Registrierung wird verwendet, um die in einer eingehenden Verbindungsanforderung angegebene SAP abzugleichen, um zu bestimmen, welcher Lauschocket diese Anforderung empfangen soll. In der aktuellen Spezifikation ist eine überlappende Registrierung nicht zulässig. Die überlappende Registrierung ist definiert, dass mehr als eine registrierte SAP-Datei vorhanden ist, die potenziell mit der in jeder eingehenden Verbindungsanforderung angegebenen SAP übereinstimmt. Listen und WSPListen geben den Fehlercode WSAEADDRINUSE zurück, wenn sich der dem Lauschocket zugeordnete SAP mit allen aktuell registrierten SAPs im System überschneidet.

Die zu registrierenden Felder in einer SAP müssen entweder einen gültigen Wert oder eine von zwei speziellen Manifestkonstanten enthalten: SAP_FIELD_ABSENT oder SAP_FIELD_ANY.

SAP_FIELD_ABSENT bedeutet einfach, dass dieses Feld nicht als Teil eines SAP dargestellt wird. SAP_FIELD_ANY bedeutet die Verwendung von Wildcards.

Beachten Sie, dass die Anforderung einer nicht überlappenden Registrierung die Verwendung von Feldhaltern nicht ausschließt. Beispielsweise ist es möglich, zwei registrierte SAPs zu haben, die beide SAP_FIELD_ANY in einigen Feldern und unterschiedliche Werte in anderen Feldern enthalten.

Hinweis Die Nummer des aufgerufenen Atm ist obligatorisch, sodass das Feld satm_number keine SAP_FIELD_ABSENT enthalten kann.

Beim Verbinden von Sockets wird die sockaddr_atm-Struktur verwendet, um die Ziel-SAP in Connect/WSAConnect/WSPConnect für Punkt-zu-Punkt-Verbindungen und WSAJoinLeaf/WSPJoinLeaf für Punkt-zu-Mehrpunkt-Verbindungen anzugeben. Die Felder im Ziel-SAP eines Verbindungssockets müssen entweder einen gültigen Wert oder SAP_FIELD_ABSENT enthalten, d. h. SAP_FIELD_ANY nicht zulässig ist.

Darüber hinaus ist SAP_FIELD_ABSENT für das feld satm_number nicht zulässig. Die Ziel-SAP wird verwendet, um mit allen registrierten SAPs auf dem Zielcomputer abzugleichen, um das Weiterleitungsziel für diese Verbindungsanforderung zu bestimmen. Wenn jedes Feld der Ziel-SAP einer eingehenden Anforderung entweder dem entsprechenden Feld einer registrierten SAP entspricht oder das entsprechende Feld die SAP_FIELD_ANY enthält, empfängt das diesem registrierten SAP zugeordnete Listensocket die eingehende Verbindungsanforderung.

Wenn Bind und/oder WSPBind in einem Verbindungssocket verwendet werden, um die ATM-Adresse des Aufrufenden anzugeben, sollten die Felder satm_blli und satm_bhli ignoriert werden, und die in connect, WSAConnect oder WSPConnect angegebenen Felder werden verwendet.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Kopfzeile	ws2atm.h