énumération WLAN_NOTIFICATION_ACM (wlanapi.h)

Article
03/04/2024

Le type énuméré WLAN_NOTIFICATION_ACM spécifie les valeurs possibles du membre NotificationCode de la structure WLAN_NOTIFICATION_DATA pour les notifications de module de configuration automatique (ACM).

Syntaxe

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;

Notes

Le WLAN_NOTIFICATION_ACM type énuméré est utilisé par le module de configuration automatique, le nouveau composant de configuration sans fil pris en charge sur Windows Vista et versions ultérieures.

Le WLAN_NOTIFICATION_ACM spécifie les valeurs possibles pour le membre NotificationCode de la structure WLAN_NOTIFICATION_DATA pour les notifications reçues lorsque le membre NotificationSource de la structure WLAN_NOTIFICATION_DATA est WLAN_NOTIFICATION_SOURCE_ACM.

La valeur de départ de l’énumération WLAN_NOTIFICATION_ACM est définie comme L2_NOTIFICATION_CODE_V2_BEGIN dans le fichier d’en-tête l2cmn.h . Notez que l’en-tête l2cmn.h est automatiquement inclus par le fichier d’en-tête wlanapi.h .

La fonction WlanRegisterNotification est utilisée par une application pour inscrire et annuler l’inscription des notifications sur toutes les interfaces sans fil. Lors de l’inscription aux notifications, une application doit fournir une fonction de rappel pointée vers le paramètre funcCallback passé à la fonction WlanRegisterNotification . Le prototype de cette fonction de rappel est le WLAN_NOTIFICATION_CALLBACK. Cette fonction de rappel recevra des notifications qui ont été inscrites dans le paramètre dwNotifSource transmis à la fonction WlanRegisterNotification .

La fonction de rappel est appelée avec un pointeur vers une structure WLAN_NOTIFICATION_DATA comme premier paramètre qui contient des informations détaillées sur la notification. La fonction de rappel reçoit également un deuxième paramètre qui contient un pointeur vers le contexte client passé dans le paramètre pCallbackContext à la fonction WlanRegisterNotification . Ce contexte client peut être un pointeur NULL si c’est ce qui a été passé à la fonction WlanRegisterNotification .

Windows XP avec SP3 et API LAN sans fil pour Windows XP avec SP2 : Seules les notifications wlan_notification_acm_connection_complete et wlan_notification_acm_disconnected sont disponibles.