sockaddr_atm 構造体 (ws2atm.h)

[アーティクル]
03/04/2024

Windows ソケット sockaddr_atm 構造体は、ATM ソケットのソケットアドレス情報を格納します。

構文

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;

メンバー

satm_family

アドレスファミリを識別します。この場合AF_ATM。

satm_number

E.164 または NSAP スタイルの ATM エンドシステムアドレス形式で使用できる ATM アドレスを識別します。このフィールドは、リッスンしているソケットの bind と WSPBind で指定されている場合、または接続ソケットの WSAConnect、 WSPConnect、 WSAJoinLeaf、または WSPJoinLeaf で指定されている場合、呼び出し先番号情報要素 (IE) にマップされます。接続ソケットの bind と WSPBind で指定されている場合は、呼び出し側番号 IE にマップされます。

satm_blli

アプリケーションを識別するために satm_bhli と共に使用される B-LLI 情報要素のフィールドを識別します。詳細については、「 ATM_BLLI 」を参照してください。 B-LLI レイヤー 2 の情報は、 Layer2Protocol フィールドにSAP_FIELD_ABSENTが含まれている場合は存在しないとして扱われ、SAP_FIELD_ANYが含まれている場合はワイルドカードとして扱われます。同様に、B-LLI レイヤー 3 の情報は、 Layer3Protocol フィールドにSAP_FIELD_ABSENTが含まれている場合は存在せず、SAP_FIELD_ANYが含まれている場合はワイルドカードとして扱われます。

satm_bhli

アプリケーションを識別するために satm_blli と共に使用される B-HLI 情報要素のフィールドを識別します。 ATM_BHLI構造の詳細については、「ATM_BHLI」を参照してください。

satm_bhliは、HighLayerInfoType フィールドにSAP_FIELD_ABSENTが含まれている場合は存在せず、SAP_FIELD_ANYが含まれている場合はワイルドカードとして扱われます。

注釈

リッスンソケットの場合、 sockaddr_atm 構造体は、この SAP 宛ての受信接続要求を受信するサービスアクセスポイント (SAP) を登録するために、バインド/WSPBind で使用されます。 SAP 登録は、受信接続要求で指定された SAP と照合して、この要求を受信するリッスンソケットを決定するために使用されます。現在の仕様では、重複登録は許可されていません。重複登録は、受信接続要求で指定された SAP と一致する可能性がある複数の登録 SAP を持つと定義されます。リッスンソケットに関連付けられている SAP がシステム内の現在登録されている SAP と重複している場合、Listen と WSPListen はエラーコード WSAEADDRINUSE を返します。

登録する SAP のフィールドには、有効な値、または 2 つの特殊なマニフェスト定数 (SAP_FIELD_ABSENT または SAP_FIELD_ANY) のいずれかが含まれている必要があります。

SAP_FIELD_ABSENTは、単にこのフィールドが SAP の一部として表示されないことを意味します。 SAP_FIELD_ANYはワイルドカードの使用を意味します。

重複しない登録の要件では、ワイルドカードの使用が妨げられないことに注意してください。たとえば、一部のフィールドにSAP_FIELD_ANYを含む 2 つの登録 SAP と、他のフィールドの異なる値を含めることができます。

メモコールパーティ ATM 番号は必須であるため、 satm_number フィールドにSAP_FIELD_ABSENTを含めることはできません。

ソケットを接続する場合、sockaddr_atm構造体を使用して、ポイント対ポイント接続の場合/はWSAConnect/WSPConnect 接続、ポイント対マルチポイント接続の場合は WSAJoinLeaf/WSPJoinLeaf の接続先 SAP を指定します。接続ソケットの宛先 SAP のフィールドには、有効な値またはSAP_FIELD_ABSENTが含まれている必要があります。つまり、SAP_FIELD_ANYは許可されません。

さらに、satm_number フィールドに対して SAP_FIELD_ABSENT を使用することはできません。宛先 SAP は、この接続要求の転送先を決定するために、移行先コンピューターに登録されているすべての SAP と照合するために使用されます。受信要求の宛先 SAP の各フィールドが登録済み SAP の対応するフィールドと等しいか、対応するフィールドにSAP_FIELD_ANYが含まれている場合、この登録済み SAP に関連付けられているリッスンソケットは受信接続要求を受け取ります。

接続先の ATM アドレスを指定するために接続ソケットで bind または WSPBind を使用する場合は、 satm_blli フィールドと satm_bhli フィールドを無視し、 connect、 WSAConnect、または WSPConnect で指定されたフィールドが使用されます。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
Header	ws2atm.h