Fungsi WskRegister (wsk.h)

Fungsi WskRegister mendaftarkan aplikasi WSK, mengingat Antarmuka Pemrograman Jaringan (NPI) klien WSK aplikasi.

Sintaks

NTSTATUS WskRegister(
  [in]  PWSK_CLIENT_NPI   WskClientNpi,
  [out] PWSK_REGISTRATION WskRegistration
);

Parameter

[in] WskClientNpi

Pointer ke NPI klien yang diimplementasikan oleh aplikasi WSK.

[out] WskRegistration

Pointer ke lokasi memori yang mengidentifikasi instans pendaftaran aplikasi WSK. Lokasi memori ini akan diinisialisasi oleh panggilan WskRegister dan akan digunakan oleh fungsi pendaftaran WSK lainnya. Aplikasi WSK tidak boleh mengubah isi lokasi memori ini secara langsung.

Nilai kembali

WskRegister mengembalikan salah satu kode NTSTATUS berikut:

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Pendaftaran berhasil.
Kode status lainnya	Pendaftaran gagal.

Keterangan

Objek klien WSK dapat memanggil fungsi ini beberapa kali, tetapi parameter WskRegistration yang berbeda harus digunakan untuk setiap panggilan untuk membuat beberapa instans pendaftaran.

Untuk setiap panggilan ke WskRegister yang mengembalikan kode sukses, harus ada tepat satu panggilan WskDeregister yang sesuai yang menggunakan parameter WskRegistration yang sama yang diteruskan ke WskRegister.

Blok memori yang diarahkan oleh WskRegistration harus tetap dialokasikan (tidak boleh dikosongkan atau keluar dari cakupan) selama ada panggilan luar biasa ke fungsi pendaftaran WSK lainnya.

Menggunakan fungsi WskRegister dan WskDeregister adalah metode yang disukai untuk mendaftarkan dan membatalkan pendaftaran aplikasi WSK. Pencatat Modul Jaringan tetap tersedia untuk kompatibilitas.

Untuk informasi selengkapnya tentang melampirkan aplikasi WSK ke subsistem WSK, lihat Mendaftarkan Aplikasi Kernel Winsock.

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)
Pustaka	Netio.lib
IRQL	PASSIVE_LEVEL

Lihat juga

WSK_CLIENT_NPI

WSK_REGISTRATION

WskDeregister