PFN_WSK_RELEASE_DATAGRAM_INDICATION_LIST fungsi panggilan balik (wsk.h)

Artikel
03/01/2024

Fungsi WskRelease merilis daftar tertaut struktur WSK_DATAGRAM_INDICATION yang sebelumnya dipertahankan oleh aplikasi WSK.

WskRelease dapat dideklarasikan dengan dua cara berbeda, tergantung pada jenis soket. Topik ini menjelaskan WskRelease untuk soket datagram. Untuk soket yang berorientasi koneksi atau mendengarkan, lihat WskRelease (soket berorientasi koneksi atau mendengarkan).

Sintaks

PFN_WSK_RELEASE_DATAGRAM_INDICATION_LIST PfnWskReleaseDatagramIndicationList;

NTSTATUS PfnWskReleaseDatagramIndicationList(
  [in] PWSK_SOCKET Socket,
  [in] PWSK_DATAGRAM_INDICATION DatagramIndication
)
{...}

Parameter

[in] Socket

Penunjuk ke struktur WSK_SOCKET yang menentukan objek soket untuk soket tempat data diterima.

[in] DatagramIndication

Penunjuk ke daftar struktur tertaut yang akan dirilis. Untuk parameter ini, aplikasi WSK harus menentukan parameter DatagramIndication yang diteruskan ke fungsi panggilan balik peristiwa WskReceiveEvent atau WskReceiveFromEvent .

Nilai kembali

WskRelease mengembalikan salah satu kode NTSTATUS berikut:

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Daftar struktur berhasil dirilis.
STATUS_INVALID_PARAMETER	Parameter yang tidak valid ditentukan.

Keterangan

Aplikasi WSK memanggil fungsi WskRelease untuk merilis daftar tertaut struktur WSK_DATAGRAM_INDICATION yang sebelumnya dipertahankan dengan mengembalikan STATUS_PENDING dari WskReceiveEvent atau fungsi panggilan balik peristiwa WskReceiveFromEvent-nya .

Menutup soket dengan memanggil fungsi WskCloseSocket tidak merilis daftar struktur tertaut yang dipertahankan yang luar biasa. Aplikasi WSK harus merilis semua daftar struktur tertaut yang dipertahankan sebelum aplikasi memanggil fungsi WskCloseSocket untuk menutup soket.

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