Bagikan melalui


Fungsi WlanRegisterVirtualStationNotification (wlanapi.h)

Fungsi WlanRegisterVirtualStationNotification digunakan untuk mendaftar dan membatalkan pendaftaran pemberitahuan di stasiun virtual.

Sintaks

DWORD WlanRegisterVirtualStationNotification(
  [in] HANDLE hClientHandle,
  [in] BOOL   bRegister,
       PVOID  pReserved
);

Parameter

[in] hClientHandle

Handel sesi klien, diperoleh dengan panggilan sebelumnya ke fungsi WlanOpenHandle .

[in] bRegister

Nilai yang menentukan apakah akan menerima pemberitahuan di stasiun virtual.

pReserved

Disiapkan untuk penggunaan masa mendatang. Parameter ini harus NULL.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan ERROR_SUCCESS.

Jika fungsi gagal, nilai yang dikembalikan mungkin salah satu kode pengembalian berikut.

Menampilkan kode Deskripsi
ERROR_INVALID_PARAMETER
Parameter salah. Kesalahan ini dikembalikan jika salah satu kondisi berikut terjadi:
  • hClientHandle adalah NULL.
  • pvReserved bukan NULL.
ERROR_INVALID_HANDLE
Handel tidak valid. Kesalahan ini dikembalikan jika handel yang ditentukan dalam parameter hClientHandle tidak ditemukan dalam tabel handel.
ERROR_INVALID_STATE
Sumber daya tidak dalam status yang benar untuk melakukan operasi yang diminta. Kesalahan ini dikembalikan jika Jaringan Yang Dihosting nirkabel dinonaktifkan oleh kebijakan grup pada domain.
ERROR_SERVICE_NOT_ACTIVE
Layanan belum dimulai. Kesalahan ini dikembalikan jika Layanan Konfigurasi Otomatis WLAN tidak berjalan.
Lainnya
Berbagai RPC dan kode kesalahan lainnya. Gunakan FormatMessage untuk mendapatkan string pesan untuk kesalahan yang dikembalikan.

Keterangan

Fungsi WlanRegisterVirtualStationNotification adalah ekstensi untuk API nirkabel asli yang ditambahkan untuk mendukung Hosted Network nirkabel pada Windows 7 dan pada Windows Server 2008 R2 dengan Layanan LAN Nirkabel terinstal.

Aplikasi klien memanggil fungsi WlanRegisterVirtualStationNotification digunakan untuk mendaftar dan membatalkan pendaftaran pemberitahuan di stasiun virtual.

Setiap pendaftaran untuk menerima pemberitahuan dari stasiun virtual yang disebabkan oleh fungsi ini akan secara otomatis dibatalkan jika aplikasi panggilan menutup handel panggilannya (dengan memanggil WlanCloseHandle dengan parameter hClientHandle ) atau jika proses berakhir.

Secara default, klien aplikasi tidak akan menerima pemberitahuan di stasiun virtual. Untuk menerima pemberitahuan ini, klien perlu memanggil fungsi WlanRegisterVirtualStationNotification dengan parameter bRegister diatur ke TRUE dan juga harus memanggil fungsi WlanRegisterNotification dengan parameter dwNotifSource yang diatur ke sumber pemberitahuan untuk didaftarkan. Pendaftaran untuk menerima pemberitahuan dari stasiun virtual berlaku sampai aplikasi menutup handel klien (dengan memanggil WlanCloseHandle dengan parameter hClientHandle ), proses berakhir, atau fungsi WlanRegisterVirtualStationNotification dipanggil dengan parameter bRegister diatur ke FALSE.

Pada Windows 7 dan yang lebih baru, sistem operasi menginstal perangkat virtual jika adaptor nirkabel yang mampu Jaringan Terhosting ada pada komputer. Perangkat virtual ini biasanya muncul di "Folder Koneksi Jaringan" sebagai 'Koneksi Jaringan Nirkabel 2' dengan Nama Perangkat 'adaptor Miniport Microsoft Virtual WiFi' jika komputer memiliki adaptor jaringan nirkabel tunggal. Perangkat virtual ini digunakan secara eksklusif untuk melakukan koneksi titik akses perangkat lunak (SoftAP) dan tidak ada dalam daftar yang dikembalikan oleh fungsi WlanEnumInterfaces . Masa pakai perangkat virtual ini terkait dengan adaptor nirkabel fisik. Jika adaptor nirkabel fisik dinonaktifkan, perangkat virtual ini juga akan dihapus. Fitur ini juga tersedia di Windows Server 2008 R2 dengan Layanan LAN Nirkabel terinstal.

Persyaratan

   
Klien minimum yang didukung Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform Windows
Header wlanapi.h (termasuk Wlanapi.h)
Pustaka Wlanapi.lib
DLL Wlanapi.dll

Lihat juga

Tentang Jaringan yang Dihosting Nirkabel

Menggunakan Jaringan yang Dihosting Nirkabel dan Berbagi Sambungan Internet

WlanCloseHandle

WlanRegisterNotification