PFN_WSK_CONNECT fungsi panggilan balik (wsk.h)

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.

Mengembalikan nilai

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

   
Klien minimum yang didukung Tersedia di Windows Vista dan versi sistem operasi Windows yang lebih baru.
Target Platform Universal
Header wsk.h (termasuk Wsk.h)
IRQL <= DISPATCH_LEVEL

Lihat juga

SOCKADDR

WSK_PROVIDER_STREAM_DISPATCH WSK_PROVIDER_CONNECTION_DISPATCH

WSK_SOCKET

WskBind

WskCloseSocket

WskDisconnect

WskDisconnectEvent

WskSocket

WskSocketConnect