struktur sockaddr_atm (ws2atm.h)
Struktur Windows Sockets sockaddr_atm menyimpan informasi alamat soket untuk soket ATM.
Sintaks
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;
Anggota
satm_family
Mengidentifikasi keluarga alamat, yang AF_ATM dalam hal ini.
satm_number
Mengidentifikasi alamat ATM yang dapat berupa format Alamat Sistem Akhir ATM bergaya E.164 atau NSAP. Bidang ini akan dipetakan ke elemen informasi nomor pihak (IE) yang disebut jika ditentukan dalam bind dan WSPBind untuk soket mendengarkan, atau di connect, WSAConnect, WSPConnect, WSAJoinLeaf, atau WSPJoinLeaf untuk soket penghubung. Ini akan dipetakan ke Nomor Pihak Panggilan IE jika ditentukan dalam ikatan dan WSPBind untuk soket penghubung.
satm_blli
Mengidentifikasi bidang dalam elemen informasi B-LLI yang digunakan bersama dengan satm_bhli untuk mengidentifikasi aplikasi. Lihat ATM_BLLI untuk detail selengkapnya. Perhatikan bahwa informasi lapisan dua B-LLI diperlakukan sebagai tidak ada jika bidang Layer2Protocol-nya berisi SAP_FIELD_ABSENT, atau sebagai wildcard jika berisi SAP_FIELD_ANY. Demikian pula, informasi lapisan B-LLI tiga diperlakukan sebagai tidak ada jika bidang Layer3Protocol-nya berisi SAP_FIELD_ABSENT, atau sebagai wildcard jika berisi SAP_FIELD_ANY.
satm_bhli
Mengidentifikasi bidang dalam elemen informasi B-HLI yang digunakan bersama dengan satm_blli untuk mengidentifikasi aplikasi. Lihat ATM_BHLI untuk informasi tentang struktur ATM_BHLI .
Keterangan
Untuk soket mendengarkan, struktur sockaddr_atm digunakan dalamWSPBind/yang mengikatuntuk mendaftarkan Titik Akses Layanan (SAP) untuk menerima permintaan koneksi masuk yang ditujukan untuk SAP ini. Pendaftaran SAP digunakan untuk mencocokkan dengan SAP yang ditentukan dalam permintaan koneksi masuk untuk menentukan soket mendengarkan mana yang akan menerima permintaan ini. Dalam spesifikasi saat ini, pendaftaran yang tumpang tindih tidak diperbolehkan. Pendaftaran yang tumpang tindih didefinisikan sebagai memiliki lebih dari satu SAP terdaftar agar berpotensi cocok dengan SAP yang ditentukan dalam permintaan koneksi masuk apa pun. Dengarkan dan WSPListen akan mengembalikan kode kesalahan WSAEADDRINUSE jika SAP yang terkait dengan soket mendengarkan tumpang tindih dengan SAP yang saat ini terdaftar dalam sistem.
Bidang dalam SAP yang akan didaftarkan harus berisi nilai yang valid, atau salah satu dari dua konstanta manifes khusus: SAP_FIELD_ABSENT atau SAP_FIELD_ANY.
SAP_FIELD_ABSENT berarti bahwa bidang ini tidak disajikan sebagai bagian dari SAP. SAP_FIELD_ANY berarti menggunakan kartubebas.
Perhatikan bahwa persyaratan pendaftaran yang tidak tumpang tindih tidak menghalangi penggunaan kartubebas. Misalnya, dimungkinkan untuk memiliki dua SAP terdaftar yang keduanya berisi SAP_FIELD_ANY di beberapa bidang dan nilai yang berbeda di bidang lain.
Selain itu, SAP_FIELD_ABSENT tidak diizinkan untuk bidang satm_number . SAP tujuan digunakan untuk mencocokkan dengan semua SAP terdaftar di komputer tujuan untuk menentukan tujuan penerusan untuk permintaan koneksi ini. Jika setiap bidang SAP tujuan dari permintaan masuk sama dengan bidang yang sesuai dari SAP terdaftar, atau bidang yang sesuai berisi SAP_FIELD_ANY, soket mendengarkan yang terkait dengan SAP terdaftar ini akan menerima permintaan koneksi masuk.
Jika Ikatan dan/atau WSPBind digunakan pada soket penghubung untuk menentukan alamat ATM pihak pemanggil, bidang satm_blli dan satm_bhli harus diabaikan dan yang ditentukan dalam sambungkan, WSAConnect, atau WSPConnect akan digunakan.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
| Header | ws2atm.h |