WLAN_NOTIFICATION_CALLBACK fungsi panggilan balik (wlanapi.h)

Artikel
03/04/2024

Prototipe fungsi panggilan balik WLAN_NOTIFICATION_CALLBACK menentukan jenis fungsi panggilan balik pemberitahuan.

Sintaks

WLAN_NOTIFICATION_CALLBACK WlanNotificationCallback;

void WlanNotificationCallback(
  PWLAN_NOTIFICATION_DATA unnamedParam1,
  PVOID unnamedParam2
)
{...}

Parameter

unnamedParam1

Penunjuk ke struktur WLAN_NOTIFICATION_DATA yang berisi informasi pemberitahuan.

Windows XP dengan SP3 dan Wireless LAN API untuk Windows XP dengan SP2: Hanya pemberitahuan wlan_notification_acm_connection_complete dan wlan_notification_acm_disconnected yang tersedia.

unnamedParam2

Penunjuk ke informasi konteks yang disediakan oleh klien saat terdaftar untuk pemberitahuan.

Mengembalikan nilai

Tidak ada

Keterangan

Fungsi WlanRegisterNotification digunakan oleh aplikasi untuk mendaftarkan dan membatalkan pendaftaran pemberitahuan pada semua antarmuka nirkabel. Saat mendaftar untuk pemberitahuan, aplikasi harus memberikan fungsi panggilan balik yang ditunjukkan oleh parameter funcCallback yang diteruskan ke fungsi WlanRegisterNotification . Prototipe untuk fungsi panggilan balik ini adalah WLAN_NOTIFICATION_CALLBACK. Fungsi panggilan balik ini akan menerima pemberitahuan yang telah terdaftar dalam parameter dwNotifSource yang diteruskan ke fungsi WlanRegisterNotification .

Fungsi panggilan balik dipanggil dengan penunjuk ke struktur WLAN_NOTIFICATION_DATA sebagai parameter pertama yang berisi informasi terperinci tentang pemberitahuan. Fungsi panggilan balik juga menerima parameter kedua yang berisi pointer ke konteks klien yang diteruskan dalam parameter pCallbackContext ke fungsi WlanRegisterNotification . Konteks klien ini dapat menjadi penunjuk NULL jika itulah yang diteruskan ke fungsi WlanRegisterNotification .

Setelah terdaftar, fungsi panggilan balik akan dipanggil setiap kali pemberitahuan tersedia sampai klien membatalkan pendaftaran atau menutup handel.

Setiap pendaftaran untuk menerima pemberitahuan secara otomatis dibatalkan jika aplikasi panggilan menutup handel panggilannya (dengan memanggil WlanCloseHandle dengan parameter hClientHandle ) yang digunakan untuk mendaftar pemberitahuan dengan fungsi WlanRegisterNotification atau jika proses berakhir.

Jika anggota NotificationSource dari struktur WLAN_NOTIFICATION_DATA yang diterima oleh fungsi panggilan balik WLAN_NOTIFICATION_SOURCE_ACM, pemberitahuan yang diterima adalah pemberitahuan modul konfigurasi otomatis. Anggota NotificationCode dari struktur WLAN_NOTIFICATION_DATA yang diteruskan ke fungsi WLAN_NOTIFICATION_CALLBACK menentukan interpretasi anggota pData struktur WLAN_NOTIFICATION_DATA . Untuk informasi selengkapnya tentang pemberitahuan ini, lihat referensi enumerasi WLAN_NOTIFICATION_ACM .

Jika anggota NotificationSource dari struktur WLAN_NOTIFICATION_DATA yang diterima oleh fungsi panggilan balik WLAN_NOTIFICATION_SOURCE_HNWK, maka pemberitahuan yang diterima adalah pemberitahuan Hosted Network nirkabel yang didukung pada Windows 7 dan pada Windows Server 2008 R2 dengan Layanan LAN Nirkabel diinstal. Anggota NotificationCode dari struktur WLAN_NOTIFICATION_DATA yang diteruskan ke fungsi WLAN_NOTIFICATION_CALLBACK menentukan interpretasi anggota pData struktur WLAN_NOTIFICATION_DATA . Untuk informasi selengkapnya tentang pemberitahuan ini, lihat referensi enumerasi WLAN_HOSTED_NETWORK_NOTIFICATION_CODE .

Jika anggota NotificationSource dari struktur WLAN_NOTIFICATION_DATA yang diterima oleh fungsi panggilan balik WLAN_NOTIFICATION_SOURCE_IHV, pemberitahuan yang diterima adalah pemberitahuan vendor perangkat keras independen (IHV). Anggota NotificationCode dari struktur WLAN_NOTIFICATION_DATA yang diteruskan ke fungsi WLAN_NOTIFICATION_CALLBACK menentukan interpretasi anggota pData dari struktur WLAN_NOTIFICATION_DATA , yang khusus untuk IHV.

Jika anggota NotificationSource dari struktur WLAN_NOTIFICATION_DATA yang diterima oleh fungsi panggilan balik WLAN_NOTIFICATION_SOURCE_ONEX, pemberitahuan yang diterima adalah pemberitahuan modul 802.1X. Anggota NotificationCode dari struktur WLAN_NOTIFICATION_DATA yang diteruskan ke fungsi WLAN_NOTIFICATION_CALLBACK menentukan interpretasi anggota pData struktur WLAN_NOTIFICATION_DATA . Untuk informasi selengkapnya tentang pemberitahuan ini, lihat referensi enumerasi ONEX_NOTIFICATION_TYPE .

Jika anggota NotificationSource dari struktur WLAN_NOTIFICATION_DATA yang diterima oleh fungsi panggilan balik WLAN_NOTIFICATION_SOURCE_MSM, pemberitahuan yang diterima adalah pemberitahuan modul khusus media (MSM). Anggota NotificationCode dari struktur WLAN_NOTIFICATION_DATA yang diteruskan ke fungsi WLAN_NOTIFICATION_CALLBACK menentukan interpretasi anggota pData struktur WLAN_NOTIFICATION_DATA . Untuk informasi selengkapnya tentang pemberitahuan ini, lihat referensi enumerasi WLAN_NOTIFICATION_MSM .

Jika anggota NotificationSource dari struktur WLAN_NOTIFICATION_DATA yang diterima oleh fungsi panggilan balik WLAN_NOTIFICATION_SOURCE_SECURITY, pemberitahuan yang diterima adalah pemberitahuan keamanan. Saat ini tidak ada pemberitahuan yang ditentukan untuk WLAN_NOTIFICATION_SOURCE_SECURITY.

Windows XP dengan SP3 dan Wireless LAN API untuk Windows XP dengan SP2: Pemberitahuan ditangani oleh layanan Netman. Jika layanan Netman dinonaktifkan atau tidak tersedia, pemberitahuan tidak akan diterima. Jika pemberitahuan tidak diterima dalam jangka waktu yang wajar, aplikasi harus kehabisan waktu dan mengkueri status antarmuka saat ini.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista, Windows XP dengan SP3 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	wlanapi.h
Redistribusi	API LAN Nirkabel untuk Windows XP dengan SP2