WLAN_NOTIFICATION_ACM wlanapi.h (列舉)

發行項
03/13/2024

WLAN_NOTIFICATION_ACM 列舉類型會指定自動設定模組 (ACM ) 通知之WLAN_NOTIFICATION_DATA結構的 NotificationCode 成員可能值。

語法

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;

備註

自動設定模組會使用 WLAN_NOTIFICATION_ACM 列舉類型，這是 Windows Vista 和更新版本上支援的新無線設定元件。

當WLAN_NOTIFICATION_DATA結構的 NotificationSource 成員WLAN_NOTIFICATION_SOURCE_ACM時，WLAN_NOTIFICATION_ACM會指定所接收通知WLAN_NOTIFICATION_DATA結構的NotificationCode 成員可能的值。

WLAN_NOTIFICATION_ACM列舉的起始值會定義為 l2cmn.h 頭檔中的L2_NOTIFICATION_CODE_V2_BEGIN。請注意，wlanapi.h 頭文件會自動包含 l2cmn.h 標頭。

WlanRegisterNotification 函式是由應用程式用來在所有無線介面上註冊和取消註冊通知。註冊通知時，應用程式必須提供傳遞至 WlanRegisterNotification 函式的 funcCallback 參數指向的回呼函式。此回呼函式的原型是 WLAN_NOTIFICATION_CALLBACK。此回呼函式會收到已向 WlanRegisterNotification 函式傳遞之 dwNotifSource 參數中註冊的通知。

呼叫回呼函式時，會以 WLAN_NOTIFICATION_DATA 結構的指標作為包含通知詳細資訊的第一個參數。回呼函式也會接收第二個參數，其中包含傳遞至 WlanRegisterNotification 函式之 pCallbackContext 參數中用戶端內容的指標。如果這是傳遞給 WlanRegisterNotification 函式的內容，則此用戶端內容可以是 NULL 指標。

Windows XP with SP3 和 Wireless LAN API for Windows XP with SP2： 只有 wlan_notification_acm_connection_complete 和 wlan_notification_acm_disconnected 通知可用。