PFN_WSK_LISTEN fungsi panggilan balik (wsk.h)

Artikel
03/01/2024

Fungsi WskListen memungkinkan soket aliran untuk mendengarkan koneksi masuk di alamat terikat soket.

Sintaks

PFN_WSK_LISTEN PfnWskListen;

NTSTATUS PfnWskListen(
  [in]      PWSK_SOCKET Socket,
  [in, out] PIRP Irp
)
{...}

Parameter

[in] Socket

Penunjuk ke struktur WSK_SOCKET yang menentukan objek soket untuk soket aliran yang mendengarkan koneksi masuk. Soket ini sebelumnya harus terikat ke alamat transportasi lokal dengan memanggil WskBind.

[in, out] Irp

Penunjuk ke IRP yang dialokasikan pemanggil yang digunakan subsistem WSK untuk menyelesaikan operasi mendengarkan secara asinkron. Untuk informasi selengkapnya tentang menggunakan IRP dengan fungsi WSK, lihat Menggunakan RUNP dengan Fungsi Kernel Winsock.

Nilai kembali

WskListen mengembalikan salah satu kode NTSTATUS berikut:

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Soket aliran berhasil mendengarkan koneksi masuk. IRP akan diselesaikan dengan status keberhasilan.
STATUS_PENDING	IRP telah diantrekan oleh subsistem WSK, yang menunggu koneksi masuk pada soket aliran.
STATUS_FILE_FORCED_CLOSED	Soket tidak lagi berfungsi. IRP akan diselesaikan dengan status kegagalan. Aplikasi WSK harus memanggil fungsi WskCloseSocket untuk menutup soket sesegera mungkin.
Kode status lainnya	Terjadi kesalahan. IRP akan diselesaikan dengan status kegagalan.

Keterangan

Aplikasi WSK dapat memanggil fungsi WskListen hanya pada soket aliran yang sebelumnya terikat dengan alamat transportasi lokal dengan memanggil fungsi WskBind . Setelah WskListen berhasil dipanggil pada soket aliran, soket berkomitmen pada alur soket mendengarkan dan tidak dapat lagi memanggil fungsi soket berorientasi koneksi.