sockaddr_atm 結構 (ws2atm.h)

發行項
03/13/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 位址。如果在系結和 WSPBind 中指定接聽套接字，或在聯機、WSAConnect、WSPConnect、WSAJoinLeaf 或 WSPJoinLeaf 中指定，此欄位將會對應至已呼叫的合作物件編號資訊元素 (IE) 。如果在系結和 WSPBind 中指定連接套接字，則會對應至呼叫方號碼 IE。

satm_blli

識別 B-LLI 資訊元素中用來識別應用程式的 欄位satm_bhli 。如需詳細資訊，請參閱ATM_BLLI 。請注意，如果 B-LLI 層第二層資訊包含SAP_FIELD_ABSENT，則會將其 Layer2Protocol 字段包含SAP_FIELD_ABSENT，或當它包含SAP_FIELD_ANY時視為通配符。同樣地，如果 B-LLI 層三層資訊包含SAP_FIELD_ABSENT，則會將其 Layer3Protocol 字段包含SAP_FIELD_ABSENT，或當它包含SAP_FIELD_ANY時視為通配符。

satm_bhli

識別 B-HLI 資訊元素中用來識別應用程式的 欄位satm_blli 。如需ATM_BHLI結構的相關信息，請參閱ATM_BHLI。

請注意，如果 HighLayerInfoType 欄位包含SAP_FIELD_ABSENT，或包含SAP_FIELD_ANY，則會將satm_bhli視為不存在。

備註

針對接聽套接字， sockaddr_atm 結構用於系結/WSPBind 來註冊服務存取點 (SAP) ，以接收目的地為此 SAP 的連入連線要求。 SAP 註冊可用來比對傳入連線要求中指定的 SAP，以判斷要接收此要求的接聽套接字。在目前的規格中，不允許重疊註冊。重疊註冊的定義是有多個已註冊的 SAP，以符合任何連入連線要求中指定的 SAP。如果與接聽套接字相關聯的 SAP 與系統中任何已註冊的 SA 重疊，則 Listen 和 WSPListen 會傳回錯誤碼 WSAEADDRINUSE。

要註冊之 SAP 中的欄位必須包含有效值，或兩個特殊指令清單常數的其中一個：SAP_FIELD_ABSENT或SAP_FIELD_ANY。

SAP_FIELD_ABSENT只是表示此字段並未呈現為 SAP 的一部分。 SAP_FIELD_ANY表示使用通配符。

請注意，非重迭註冊的需求不會排除使用通配符。例如，可以有兩個已註冊的 SAP 同時包含某些欄位中的SAP_FIELD_ANY，以及其他欄位中的不同值。

注意呼叫方 ATM 號碼是必要的，因此 satm_number 欄位不能包含SAP_FIELD_ABSENT。

針對連接套接字，sockaddr_atm 結構可用來指定連接WSAConnect WSPConnect/中的/目的地 SAP，以進行點對點連線，以及用於點對多點連線的 WSAJoinLeaf WSPJoinLeaf/。連接套接字目的地 SAP 中的字段必須包含有效的值或SAP_FIELD_ABSENT，也就是不允許SAP_FIELD_ANY。

此外，satm_number欄位不允許 SAP_FIELD_ABSENT 。目的地 SAP 是用來比對目的地計算機中所有已註冊的 SA，以判斷此連線要求的轉送目的地。如果傳入要求之目的地 SAP 的每個和每個欄位都等於已註冊 SAP 的對應欄位，或對應的欄位包含SAP_FIELD_ANY，則與此已註冊 SAP 相關聯的接聽套接字將會收到連入連線要求。

如果在連線套接字上使用 bind 和/或 WSPBind 來指定呼叫端 ATM 位址，則應該忽略 satm_blli 和 satm_bhli 欄位，並使用連線、 WSAConnect 或 WSPConnect 中指定的欄位。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
標頭	ws2atm.h