Fungsi panggilan balik LPWSPGETSOCKNAME (ws2spi.h)
Fungsi LPWSPGetSockName mendapatkan nama lokal untuk soket.
Sintaks
LPWSPGETSOCKNAME Lpwspgetsockname;
int Lpwspgetsockname(
[in] SOCKET s,
[out] sockaddr *name,
[in, out] LPINT namelen,
[out] LPINT lpErrno
)
{...}
Parameter
[in] s
Deskriptor mengidentifikasi soket terikat.
[out] name
Penunjuk ke struktur sockaddr yang digunakan untuk menyediakan alamat (nama) soket.
[in, out] namelen
Pada input, arahkan ke bilangan bulat yang menunjukkan ukuran struktur yang diarahkan berdasarkan nama, dalam byte. Pada output menunjukkan ukuran nama yang dikembalikan, dalam byte.
[out] lpErrno
Arahkan ke kode kesalahan.
Menampilkan nilai
Jika tidak ada kesalahan yang terjadi, LPWSPGetSockName mengembalikan nol. Jika tidak, nilai SOCKET_ERROR dikembalikan, dan kode kesalahan tertentu tersedia di lpErrno.
Kode Kesalahan | Makna |
---|---|
Subsistem jaringan gagal. | |
Nama atau parameter namelen bukan bagian yang valid dari ruang alamat pengguna, atau parameter namelen terlalu kecil. | |
Fungsi dipanggil saat panggilan balik sedang berlangsung. | |
Deskriptor bukan soket. | |
Soket belum terikat ke alamat dengan LPWSPBind, atau ADDR_ANY ditentukan dalam **LPWSPBind** tetapi koneksi belum terjadi. |
Keterangan
LPWSPGetSockName mengambil nama saat ini untuk deskriptor soket yang ditentukan dalam nama. Ini digunakan pada soket terikat dan/atau terhubung yang ditentukan oleh parameter s . Asosiasi lokal dikembalikan. Panggilan ini sangat berguna ketika panggilan LPWSPConnect telah dilakukan tanpa melakukan LPWSPBind terlebih dahulu; karena panggilan ini menyediakan satu-satunya cara asosiasi lokal yang telah ditetapkan oleh penyedia layanan dapat ditentukan.
Jika soket terikat ke alamat yang tidak ditentukan (misalnya, ADDR_ANY), menunjukkan bahwa salah satu alamat host dalam keluarga alamat yang ditentukan harus digunakan untuk soket, LPWSPGetSockNametidak akan selalu mengembalikan informasi tentang alamat host, kecuali soket telah terhubung dengan LPWSPConnect atau LPWSPAccept. Klien Windows Sockets SPI tidak boleh berasumsi bahwa alamat akan ditentukan kecuali soket tersambung. Ini karena untuk host multihomed, alamat yang akan digunakan untuk soket tidak diketahui sampai soket tersambung.
Persyaratan
Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
Header | ws2spi.h |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk