enumeração WLAN_NOTIFICATION_ACM (wlanapi.h)

Artigo
08/28/2023

O tipo enumerado WLAN_NOTIFICATION_ACM especifica os valores possíveis do membro NotificationCode da estrutura WLAN_NOTIFICATION_DATA para notificações do Módulo de Configuração Automática (ACM).

Sintaxe

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;

Comentários

O WLAN_NOTIFICATION_ACM tipo enumerado é usado pelo Módulo de Configuração Automática, o novo componente de configuração sem fio com suporte no Windows Vista e posterior.

O WLAN_NOTIFICATION_ACM especifica os valores possíveis para o membro NotificationCode da estrutura WLAN_NOTIFICATION_DATA para notificações recebidas quando o membro NotificationSource da estrutura WLAN_NOTIFICATION_DATA é WLAN_NOTIFICATION_SOURCE_ACM.

O valor inicial da enumeração WLAN_NOTIFICATION_ACM é definido como L2_NOTIFICATION_CODE_V2_BEGIN no arquivo de cabeçalho l2cmn.h . Observe que o cabeçalho l2cmn.h é incluído automaticamente pelo arquivo de cabeçalho wlanapi.h .

A função WlanRegisterNotification é usada por um aplicativo para registrar e cancelar o registro de notificações em todas as interfaces sem fio. Ao se registrar para notificações, um aplicativo deve fornecer uma função de retorno de chamada apontada pelo parâmetro funcCallback passado para a função WlanRegisterNotification . O protótipo dessa função de retorno de chamada é o WLAN_NOTIFICATION_CALLBACK. Essa função de retorno de chamada receberá notificações que foram registradas no parâmetro dwNotifSource passadas para a função WlanRegisterNotification .

A função de retorno de chamada é chamada com um ponteiro para uma estrutura WLAN_NOTIFICATION_DATA como o primeiro parâmetro que contém informações detalhadas sobre a notificação. A função de retorno de chamada também recebe um segundo parâmetro que contém um ponteiro para o contexto do cliente passado no parâmetro pCallbackContext para a função WlanRegisterNotification . Esse contexto de cliente poderá ser um ponteiro NULL se for isso que foi passado para a função WlanRegisterNotification .

Windows XP com SP3 e API lan sem fio para Windows XP com SP2: Somente as notificações de wlan_notification_acm_connection_complete e wlan_notification_acm_disconnected estão disponíveis.