PFN_WSK_INSPECT_COMPLETE fungsi panggilan balik (wsk.h)

Artikel
08/08/2023

Fungsi WskInspectComplete menyelesaikan inspeksi permintaan koneksi masuk yang sebelumnya tertunda yang diterima pada soket mendengarkan yang mengaktifkan mode terima kondisional.

Sintaks

PFN_WSK_INSPECT_COMPLETE PfnWskInspectComplete;

NTSTATUS PfnWskInspectComplete(
  [in]      PWSK_SOCKET ListenSocket,
  [in]      PWSK_INSPECT_ID InspectID,
  [in]      WSK_INSPECT_ACTION Action,
  [in, out] PIRP Irp
)
{...}

Parameter

[in] ListenSocket

Penunjuk ke struktur WSK_SOCKET . Penunjuk ini menentukan soket mendengarkan tempat aplikasi WSK menerima permintaan koneksi masuk yang diperiksa.

[in] InspectID

Penunjuk ke struktur WSK_INSPECT_ID . Konten struktur mengidentifikasi permintaan koneksi tertentu yang diperiksa oleh aplikasi WSK.

[in] Action

Nilai yang menentukan apakah aplikasi WSK menerima atau menolak permintaan koneksi masuk. Aplikasi WSK harus menentukan WskInspectAccept atau WskInspectReject untuk parameter ini.

[in, out] Irp

Penunjuk ke IRP yang dialokasikan penelepon yang digunakan subsistem WSK untuk menyelesaikan operasi resume secara asinkron. Untuk informasi selengkapnya tentang menggunakan runtime integrasi dengan fungsi WSK, lihat Menggunakan IRP dengan Fungsi Kernel Winsock.

Nilai kembali

WskInspectComplete mengembalikan salah satu kode NTSTATUS berikut:

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Operasi pemeriksaan yang sebelumnya tertunda berhasil dilanjutkan. IRP akan diselesaikan dengan status keberhasilan.
STATUS_PENDING	Subsistem WSK tidak dapat segera melanjutkan operasi pemeriksaan. Subsistem WSK akan menyelesaikan IRP setelah melanjutkan operasi pemeriksaan permintaan koneksi masuk. Status melanjutkan operasi pemeriksaan akan dikembalikan di bidang IoStatus.Status dari IRP.
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 memanggil fungsi WskInspectComplete untuk menyelesaikan pemeriksaan permintaan koneksi masuk yang fungsi panggilan balik peristiwa WskInspectEvent aplikasi sebelumnya mengembalikan WskInspectPend.

Aplikasi WSK dapat memanggil fungsi WskInspectComplete hanya pada soket mendengarkan yang mengaktifkan mode terima bersyarkat. Aplikasi WSK dapat mengaktifkan mode terima kondisional pada soket mendengarkan dengan mengaktifkan opsi soket SO_CONDITIONAL_ACCEPT . Untuk informasi selengkapnya tentang menerima koneksi masuk secara kondisional, lihat Mendengarkan dan Menerima Connections Masuk.

Subsistem WSK meneruskan penunjuk ke struktur WSK_INSPECT_ID ke aplikasi WSK ketika disebut fungsi panggilan balik peristiwa WskInspectEvent aplikasi. Aplikasi WSK menyalin konten struktur tersebut ke struktur WSK_INSPECT_ID sendiri sebelum mengembalikan WskInspectPend dari fungsi panggilan balik peristiwa WskInspectEvent . Aplikasi WSK meneruskan pointer ke struktur WSK_INSPECT_ID sendiri dalam parameter InspectID saat memanggil fungsi WskInspectComplete .

Jika aplikasi WSK menentukan WskInspectAccept dalam parameter Tindakan , subsistem WSK akan terus membuat koneksi soket. Subsistem WSK akan mengembalikan soket ke aplikasi WSK dengan menyelesaikan panggilan oleh aplikasi WSK ke fungsi WskAccept atau memanggil fungsi panggilan balik peristiwa WskAccept aplikasi WSK jika diaktifkan. Jika permintaan koneksi masuk dihilangkan sebelum koneksi soket sepenuhnya dibuat, subsistem WSK akan memanggil fungsi panggilan balik peristiwa WskAbortEvent aplikasi WSK .

Jika aplikasi WSK menentukan WskInspectReject dalam parameter Tindakan , permintaan koneksi masuk dihilangkan, dan koneksi soket tidak dibuat.

Jika permintaan koneksi masuk dihilangkan oleh sistem jarak jauh sebelum aplikasi WSK memanggil fungsi WskInspectComplete , subsistem WSK memanggil fungsi panggilan balik peristiwa WskAbortEvent aplikasi WSK .

Jika aplikasi WSK memanggil fungsi WskInspectComplete pada permintaan koneksi masuk yang telah dibatalkan, koneksi tidak akan dibuat meskipun aplikasi WSK menentukan WskInspectAccept dalam parameter Tindakan .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows Vista dan versi yang lebih baru dari sistem operasi Windows.
Target Platform	Universal
Header	wsk.h (termasuk Wsk.h)
IRQL	<= DISPATCH_LEVEL