PFN_WSK_CONNECT fungsi panggilan balik (wsk.h)

Artikel
03/05/2024

Fungsi WskConnect menyambungkan soket berorientasi koneksi atau aliran ke alamat transportasi jarak jauh.

Sintaks

PFN_WSK_CONNECT PfnWskConnect;

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

Parameter

[in] Socket

Penunjuk ke struktur WSK_SOCKET yang menentukan objek soket untuk soket yang tersambung ke alamat transportasi jarak jauh.

[in] RemoteAddress

Penunjuk ke struktur yang menentukan alamat transportasi jarak jauh untuk menyambungkan 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 koneksi secara asinkron. Untuk informasi selengkapnya tentang menggunakan IRP dengan fungsi WSK, lihat Menggunakan RUNP dengan Fungsi Kernel Winsock.

Nilai kembali

WskConnect mengembalikan salah satu kode NTSTATUS berikut:

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Soket berhasil tersambung ke alamat transportasi jarak jauh. IRP akan diselesaikan dengan status keberhasilan.
STATUS_PENDING	Subsistem WSK tidak dapat segera menyambungkan soket. Subsistem WSK akan menyelesaikan IRP setelah menyambungkan soket ke alamat transportasi jarak jauh. Status operasi sambungkan 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 dapat memanggil fungsi WskConnect hanya pada soket berorientasi koneksi atau streaming yang sebelumnya terikat dengan alamat transportasi lokal dengan memanggil fungsi WskBind .

Untuk soket streaming, setelah WskConnect berhasil dipanggil pada soket streaming, soket berkomitmen pada alur berorientasi koneksi dan mungkin tidak lagi memanggil fungsi soket mendengarkan.

Aplikasi WSK dapat membuat, mengikat, dan menyambungkan soket berorientasi koneksi dalam satu panggilan fungsi dengan memanggil fungsi WskSocketConnect daripada memanggil fungsi WskSocket , fungsi WskBind , lalu fungsi WskConnect . Sebaiknya panggil fungsi WskSocketConnect kecuali aplikasi WSK perlu mengatur opsi soket atau mengeluarkan operasi kontrol I/O sebelum mengikat atau menyambungkan 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