Bagikan melalui

Fungsi panggilan balik LPWSPGETSOCKNAME (ws2spi.h)

  • Artikel

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
WSAENETDOWN
 Subsistem jaringan gagal.
WSAEFAULT
 Nama atau parameter namelen bukan bagian yang valid dari ruang alamat pengguna, atau parameter namelen terlalu kecil.
WSAEINPROGRESS
 Fungsi dipanggil saat panggilan balik sedang berlangsung.
WSAENOTSOCK
 Deskriptor bukan soket.
WSAEINVAL
 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

LPWSPBind

LPWSPGetPeerName

LPWSPSocket