enumerasi WLAN_NOTIFICATION_ACM (wlanapi.h)

Artikel
03/20/2023

Jenis enumerasi WLAN_NOTIFICATION_ACM menentukan nilai yang mungkin dari anggota NotificationCode dari struktur WLAN_NOTIFICATION_DATA untuk pemberitahuan Modul Konfigurasi Otomatis (ACM).

Sintaks

typedef enum _WLAN_NOTIFICATION_ACM {
  wlan_notification_acm_start,
  wlan_notification_acm_autoconf_enabled,
  wlan_notification_acm_autoconf_disabled,
  wlan_notification_acm_background_scan_enabled,
  wlan_notification_acm_background_scan_disabled,
  wlan_notification_acm_bss_type_change,
  wlan_notification_acm_power_setting_change,
  wlan_notification_acm_scan_complete,
  wlan_notification_acm_scan_fail,
  wlan_notification_acm_connection_start,
  wlan_notification_acm_connection_complete,
  wlan_notification_acm_connection_attempt_fail,
  wlan_notification_acm_filter_list_change,
  wlan_notification_acm_interface_arrival,
  wlan_notification_acm_interface_removal,
  wlan_notification_acm_profile_change,
  wlan_notification_acm_profile_name_change,
  wlan_notification_acm_profiles_exhausted,
  wlan_notification_acm_network_not_available,
  wlan_notification_acm_network_available,
  wlan_notification_acm_disconnecting,
  wlan_notification_acm_disconnected,
  wlan_notification_acm_adhoc_network_state_change,
  wlan_notification_acm_profile_unblocked,
  wlan_notification_acm_screen_power_change,
  wlan_notification_acm_profile_blocked,
  wlan_notification_acm_scan_list_refresh,
  wlan_notification_acm_operational_state_change,
  wlan_notification_acm_end
} WLAN_NOTIFICATION_ACM, *PWLAN_NOTIFICATION_ACM;

Keterangan

Jenis enumerasi WLAN_NOTIFICATION_ACM digunakan oleh Modul Konfigurasi Otomatis, komponen konfigurasi nirkabel baru yang didukung pada Windows Vista dan yang lebih baru.

WLAN_NOTIFICATION_ACM menentukan nilai yang mungkin untuk anggota NotificationCode dari struktur WLAN_NOTIFICATION_DATA untuk pemberitahuan yang diterima saat anggota NotificationSource dari struktur WLAN_NOTIFICATION_DATAWLAN_NOTIFICATION_SOURCE_ACM.

Nilai awal untuk enumerasi WLAN_NOTIFICATION_ACM didefinisikan sebagai L2_NOTIFICATION_CODE_V2_BEGIN dalam file header l2cmn.h . Perhatikan bahwa header l2cmn.h secara otomatis disertakan oleh file header wlanapi.h .

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 .

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.