WLAN_NOTIFICATION_ACM-Enumeration (wlanapi.h)

Artikel
03/04/2024

Der WLAN_NOTIFICATION_ACM aufgezählten Typ gibt die möglichen Werte des NotificationCode-Elements der WLAN_NOTIFICATION_DATA-Struktur für ACM-Benachrichtigungen (Auto Configuration Module) an.

Syntax

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;

Hinweise

Der WLAN_NOTIFICATION_ACM Enumerated-Typ wird vom Auto Configuration Module verwendet, der neuen drahtlosen Konfigurationskomponente, die unter Windows Vista und höher unterstützt wird.

Die WLAN_NOTIFICATION_ACM gibt die möglichen Werte für das NotificationCode-Element der WLAN_NOTIFICATION_DATA-Struktur für empfangene Benachrichtigungen an, wenn das NotificationSource-Element der WLAN_NOTIFICATION_DATA-StrukturWLAN_NOTIFICATION_SOURCE_ACM ist.

Der Startwert für die WLAN_NOTIFICATION_ACM-Enumeration ist als L2_NOTIFICATION_CODE_V2_BEGIN in der Headerdatei l2cmn.h definiert. Beachten Sie, dass der Header l2cmn.h automatisch in der Headerdatei wlanapi.h enthalten ist.

Die WlanRegisterNotification-Funktion wird von einer Anwendung verwendet, um Benachrichtigungen auf allen drahtlosen Schnittstellen zu registrieren und aufzuheben. Bei der Registrierung für Benachrichtigungen muss eine Anwendung eine Rückruffunktion bereitstellen, auf die der funcCallback-Parameter verweist, der an die WlanRegisterNotification-Funktion übergeben wird. Der Prototyp für diese Rückruffunktion ist die WLAN_NOTIFICATION_CALLBACK. Diese Rückruffunktion empfängt Benachrichtigungen, die im dwNotifSource-Parameter registriert wurden, die an die WlanRegisterNotification-Funktion übergeben werden.

Die Rückruffunktion wird mit einem Zeiger auf eine WLAN_NOTIFICATION_DATA-Struktur als ersten Parameter aufgerufen, der detaillierte Informationen zur Benachrichtigung enthält. Die Rückruffunktion empfängt auch einen zweiten Parameter, der einen Zeiger auf den Clientkontext enthält, der im pCallbackContext-Parameter an die WlanRegisterNotification-Funktion übergeben wird. Dieser Clientkontext kann ein NULL-Zeiger sein, wenn dieser an die WlanRegisterNotification-Funktion übergeben wurde.

Windows XP mit SP3 und Wlan-API für Windows XP mit SP2: Nur die wlan_notification_acm_connection_complete - und wlan_notification_acm_disconnected benachrichtigungen sind verfügbar.