PFN_WSK_BIND fungsi panggilan balik (wsk.h)

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 sedang 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 disediakan untuk penggunaan sistem. Aplikasi WSK harus mengatur parameter ini ke nol.

[in, out] Irp

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

Mengembalikan nilai

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 pengikatan 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 kartubebas lokal, tumpukan jaringan mengikat soket ke alamat transportasi lokal yang tersedia. WskBind harus dipanggil sebelum memanggil fungsi WskListen atau WskConnect .

Persyaratan

   
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

Lihat juga

SOCKADDR

WSK_PROVIDER_DATAGRAM_DISPATCH WSK_PROVIDER_CONNECTION_DISPATCH

WSK_PROVIDER_LISTEN_DISPATCH

WSK_PROVIDER_STREAM_DISPATCH

WSK_SOCKET

WskCloseSocket

WskConnect

WskSocket