Перечисление WLAN_NOTIFICATION_ACM (wlanapi.h)

Статья
03/13/2024

Перечислимый тип WLAN_NOTIFICATION_ACM указывает возможные значения элемента NotificationCodeструктуры WLAN_NOTIFICATION_DATA для уведомлений модуля автоматической настройки (ACM).

Синтаксис

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;

Remarks

Перечислимый тип WLAN_NOTIFICATION_ACM используется модулем автоматической настройки, новым компонентом конфигурации беспроводной сети, поддерживаемым в Windows Vista и более поздних версиях.

В WLAN_NOTIFICATION_ACM указываются возможные значения элемента NotificationCode структуры WLAN_NOTIFICATION_DATA для полученных уведомлений, если элемент NotificationSourceструктуры WLAN_NOTIFICATION_DATAWLAN_NOTIFICATION_SOURCE_ACM.

Начальное значение перечисления WLAN_NOTIFICATION_ACM определяется как L2_NOTIFICATION_CODE_V2_BEGIN в файле заголовка l2cmn.h . Обратите внимание, что заголовок l2cmn.h автоматически включается в файл заголовка wlanapi.h .

Функция WlanRegisterNotification используется приложением для регистрации и отмены регистрации уведомлений на всех беспроводных интерфейсах. При регистрации для уведомлений приложение должно предоставить функцию обратного вызова, на которую указывает параметр funcCallback , передаваемый в функцию WlanRegisterNotification . Прототипом этой функции обратного вызова является WLAN_NOTIFICATION_CALLBACK. Эта функция обратного вызова будет получать уведомления, зарегистрированные в параметре dwNotifSource , переданном в функцию WlanRegisterNotification .

Функция обратного вызова вызывается с указателем на структуру WLAN_NOTIFICATION_DATA в качестве первого параметра, содержащего подробные сведения об уведомлении. Функция обратного вызова также получает второй параметр, содержащий указатель на контекст клиента, переданный в параметре pCallbackContext в функцию WlanRegisterNotification . Этот контекст клиента может быть указателем NULL , если это то, что было передано в функцию WlanRegisterNotification .

Windows XP с пакетом обновления 3 (SP3) и API беспроводной локальной сети для Windows XP с пакетом обновления 2 (SP2): Доступны только уведомления wlan_notification_acm_connection_complete и wlan_notification_acm_disconnected .

Требования

Требование	Значение
Минимальная версия клиента	сборка Windows 10 20348
Минимальная версия сервера	сборка Windows 10 20348
Верхняя часть	wlanapi.h