PFN_WSK_BIND fungsi panggilan balik (wsk.h)

Artikel
08/08/2023

Fungsi WskBind mengikat soket ke alamat transportasi lokal.

Sintaks

PFN_WSK_BIND PfnWskBind;

NTSTATUS PfnWskBind(
  [in]      PWSK_SOCKET Socket,
  [in]      PSOCKADDR LocalAddress,
            ULONG Flags,
  [in, out] PIRP Irp
)
{...}

Parameter

[in] Socket

Penunjuk ke struktur WSK_SOCKET yang menentukan objek soket untuk soket yang terikat.

[in] LocalAddress

Penunjuk ke struktur yang menentukan alamat transportasi lokal yang akan mengikat soket. Penunjuk ini harus menjadi penunjuk ke jenis struktur SOCKADDR tertentu yang sesuai dengan keluarga alamat yang ditentukan aplikasi WSK saat membuat soket.

Flags

Parameter ini dicadangkan untuk penggunaan sistem. Aplikasi WSK harus mengatur parameter ini ke nol.

[in, out] Irp

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

Nilai kembali

WskBind mengembalikan salah satu kode NTSTATUS berikut:

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Soket berhasil terikat ke alamat transportasi lokal. IRP akan diselesaikan dengan status keberhasilan.
STATUS_PENDING	Subsistem WSK tidak dapat segera mengikat soket. Subsistem WSK akan menyelesaikan IRP setelah terikat soket ke alamat transportasi lokal. Status operasi ikatan 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

Untuk soket mendengarkan, memanggil fungsi WskBind menyiapkan soket untuk mendengarkan permintaan koneksi masuk pada alamat transportasi lokal yang ditentukan. Jika aplikasi WSK menentukan alamat wildcard lokal, soket akan mendengarkan permintaan koneksi masuk di semua alamat transportasi lokal.

Untuk soket datagram, memanggil fungsi WskBind menyiapkan soket untuk mengirim dan menerima datagram pada alamat transportasi lokal yang ditentukan. Jika aplikasi WSK menentukan alamat wildcard lokal, soket akan menerima datagram pada semua alamat transportasi lokal dan akan mengirim datagram dari alamat transportasi lokal yang sesuai yang ditentukan oleh informasi perutean sistem.

Untuk soket berorientasi koneksi, memanggil fungsi WskBind mengikat soket ke alamat transportasi lokal yang ditentukan. WskBind harus dipanggil sebelum memanggil fungsi WskConnect . Jika aplikasi WSK menentukan alamat wildcard lokal, tumpukan jaringan mengikat soket ke alamat transportasi lokal yang sesuai saat aplikasi memanggil WskConnect untuk menyambungkan soket ke alamat transportasi jarak jauh. Dalam situasi seperti itu, alamat transportasi lokal ditentukan oleh informasi perutean sistem.

Untuk soket aliran, memanggil fungsi WskBind mengikat soket ke alamat transportasi lokal yang ditentukan. Jika aplikasi WSK menentukan alamat wildcard lokal, tumpukan jaringan mengikat soket ke alamat transportasi lokal yang tersedia. WskBind harus dipanggil sebelum memanggil fungsi WskListen atau WskConnect .

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