PFN_WSK_RELEASE_DATA_INDICATION_LIST fungsi panggilan balik (wsk.h)

Artikel
02/27/2024

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

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

Sintaks

PFN_WSK_RELEASE_DATA_INDICATION_LIST PfnWskReleaseDataIndicationList;

NTSTATUS PfnWskReleaseDataIndicationList(
  [in] PWSK_SOCKET Socket,
  [in] PWSK_DATA_INDICATION DataIndication
)
{...}

Parameter

[in] Socket

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

[in] DataIndication

Penunjuk ke daftar struktur tertaut yang akan dirilis. Untuk parameter ini, aplikasi WSK harus menentukan parameter DataIndication 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 buffer berhasil dirilis.
STATUS_INVALID_PARAMETER	Parameter yang tidak valid ditentukan.

Keterangan

Untuk soket yang berorientasi koneksi atau mendengarkan, aplikasi WSK memanggil fungsi WskRelease untuk merilis daftar tertaut struktur WSK_DATA_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