Fungsi WPUQuerySocketHandleContext (ws2spi.h)

Artikel
03/13/2024

Fungsi WPUQuerySocketHandleContext meminta nilai konteks yang terkait dengan handel soket yang ditentukan.

Sintaks

int WPUQuerySocketHandleContext(
  [in]  SOCKET     s,
  [out] PDWORD_PTR lpContext,
  [out] LPINT      lpErrno
);

Parameter

[in] s

Deskripsi yang mengidentifikasi soket yang konteksnya akan dikueri.

[out] lpContext

Pointer yang akan menerima nilai konteks.

[out] lpErrno

Arahkan ke kode kesalahan.

Mengembalikan nilai

Jika tidak ada kesalahan yang terjadi, WPUQuerySocketHandleContext mengembalikan nol dan menyimpan nilai konteks saat ini di lpContext. Jika tidak, kode mengembalikan SOCKET_ERROR, dan kode kesalahan tertentu tersedia di lpErrno.

Kode kesalahan	Makna
WSAENOTSOCK	Deskriptor bukan soket yang dibuat oleh WPUCreateSocketHandle.

Keterangan

Fungsi WPUQuerySocketHandleContext meminta nilai konteks saat ini yang terkait dengan handel soket yang ditentukan. Penyedia layanan biasanya menggunakan fungsi ini untuk mengambil pointer ke data khusus penyedia yang terkait dengan soket. Misalnya, penyedia layanan dapat menggunakan konteks soket untuk menyimpan pointer ke struktur yang berisi status soket, alamat transportasi lokal dan jarak jauh, dan objek peristiwa untuk memberi sinyal peristiwa jaringan.

Hanya penyedia non-IFS yang menggunakan fungsi ini, karena penyedia IFS tidak dapat menyediakan nilai konteks.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	ws2spi.h

Lihat juga

WPUCreateSocketHandle

Bagikan melalui