次の方法で共有


WLAN_NOTIFICATION_DATA (Compact 2013)

3/26/2014

This structure contains information that is provided when registering for notifications.

Syntax

typedef struct _WLAN_NOTIFICATION_DATA {
  DWORD NotificationSource;
  DWORD NotificationCode;
  GUID InterfaceGuid;
  DWORD dwDataSize;
  PVOID pData;
} WLAN_NOTIFICATION_DATA,
  *PWLAN_NOTIFICATION_DATA;

Members

  • NotificationSource
    Specifies where the notification comes from

    Value

    Meaning

    WLAN_NOTIFICATION_SOURCE_NONE

    Unregisters notifications

    WLAN_NOTIFICATION_SOURCE_ALL

    Registers for all notifications, including those generated by the 802.1X module

    WLAN_NOTIFICATION_SOURCE_ACM

    Registers for notifications generated by the auto configuration module

    WLAN_NOTIFICATION_SOURCE_MSM

    Registers for notifications generated by MSM

    WLAN_NOTIFICATION_SOURCE_SECURITY

    Registers for notifications generated by the security module

    WLAN_NOTIFICATION_SOURCE_IHV

    Registers for notifications generated by independent hardware vendors (IHV)

  • NotificationCode
    Indicates the type of notification. The value of this member indicates what type of associated data will be present in pData:

    NotificationCode Value

    pData Data Type

    wlan_notification_acm_autoconf_enabled

    None

    wlan_notification_acm_autoconf_disabled

    None

    wlan_notification_acm_background_scan_enabled

    None

    wlan_notification_acm_background_scan_disabled

    None

    wlan_notification_acm_bss_type_change

    DOT11_BSS_TYPE

    wlan_notification_acm_power_setting_change

    WLAN_POWER_SETTING

    wlan_notification_acm_scan_complete

    None

    wlan_notification_acm_scan_fail

    WLAN_REASON_CODE

    wlan_notification_acm_connection_start

    WLAN_CONNECTION_NOTIFICATION_DATA

    wlan_notification_acm_connection_complete

    WLAN_CONNECTION_NOTIFICATION_DATA

    wlan_notification_acm_connection_attempt_fail

    WLAN_CONNECTION_NOTIFICATION_DATA

    wlan_notification_acm_filter_list_change

    None

    wlan_notification_acm_interface_arrival

    None

    wlan_notification_acm_interface_removal

    None

    wlan_notification_acm_profile_change

    None

    wlan_notification_acm_profile_name_change

    Two strings, the old profile name followed by the new profile name

    wlan_notification_acm_profiles_exhausted

    None

    wlan_notification_acm_network_not_available

    None

    wlan_notification_acm_network_available

    None

    wlan_notification_acm_disconnecting

    WLAN_CONNECTION_NOTIFICATION_DATA

    wlan_notification_acm_disconnected

    WLAN_CONNECTION_NOTIFICATION_DATA

    wlan_notification_acm_adhoc_network_state_change

    WLAN_ADHOC_NETWORK_STATE

    wlan_notification_msm_start

    WLAN_MSM_NOTIFICATION_DATA

    wlan_notification_msm_associating

    WLAN_MSM_NOTIFICATION_DATA3

    wlan_notification_msm_associated

    WLAN_MSM_NOTIFICATION_DATA3

    wlan_notification_msm_authenticating

    WLAN_MSM_NOTIFICATION_DATA3

    wlan_notification_msm_connected

    WLAN_MSM_NOTIFICATION_DATA

    wlan_notification_msm_roaming_start

    WLAN_MSM_NOTIFICATION_DATA

    wlan_notification_msm_roaming_end

    WLAN_MSM_NOTIFICATION_DATA

    wlan_notification_msm_radio_state_change

    WLAN_PHY_RADIO_STATE

    wlan_notification_msm_signal_quality_change

    WLAN_SIGNAL_QUALITY (ULONG)

    wlan_notification_msm_disassociating

    WLAN_MSM_NOTIFICATION_DATA3

    wlan_notification_msm_disconnected

    WLAN_MSM_NOTIFICATION_DATA3

    wlan_notification_msm_peer_join

    WLAN_MSM_NOTIFICATION_DATA3

    wlan_notification_msm_peer_leave

    WLAN_MSM_NOTIFICATION_DATA3

    wlan_notification_msm_adapter_removal

    WLAN_MSM_NOTIFICATION_DATA3

    wlan_notification_msm_adapter_operation_mode_change

    ULONG

  • InterfaceGuid
    Specifies the interface for the notification
  • dwDataSize
    Specifies the size of pData, in bytes
  • pData
    Pointer to additional data needed for the notification, as indicated by NotificationCode

Remarks

The wlan_notification_msm_peer_join and wlan_notification_msm_peer_leave notifications are used only when a computer creates an ad hoc network. These notifications are not used when a computer joins an existing ad hoc network.

The wlan_notification_msm_adapter_operation_mode_change notification is used when the operation mode changes. Two operation modes are supported: DOT11_OPERATION_MODE_EXTENSIBLE_STATION and DOT11_OPERATION_MODE_NETWORK_MONITOR. The operation mode constants are defined in the header file Windot11.h. When this notification is sent, pData points to the current operation mode.

The wlan_notification_acm_connection_attempt_fail notification is used only when an application tries and cannot initiate a connection by using WlanConnect. This notification is sent for each failed SSID. The wlanReasonCode member of the WLAN_CONNECTION_NOTIFICATION_DATA structure included with the notification data specifies the reason the SSID failed.

If all SSIDs fail when a connection is initiated by using WlanConnect, the notification wlan_notification_acm_connection_complete is sent with wlanReasonCode set to WLAN_REASON_CODE_NETWORK_NOT_AVAILABLE. If at least one SSID succeeds, the notification is sent with wlanReasonCode set to WLAN_REASON_CODE_SUCCESS.

Unlike wlan_notification_acm_connection_attempt_fail, the wlan_notification_acm_connection_complete notification is sent for automatic connections and for connections initiated by using WlanConnect. If the connection succeeds, wlanReasonCode set to WLAN_REASON_CODE_SUCCESS. Otherwise, wlanReasonCode specifies the reason for failure.

An application can time out and query the current interface state instead of waiting for a notification.

See Also

Reference

Native Wi-Fi Structures
DOT11_BSS_TYPE
WLAN_POWER_SETTING
WLAN_REASON_CODE
WLAN_CONNECTION_NOTIFICATION_DATA
WLAN_ADHOC_NETWORK_STATE
WLAN_MSM_NOTIFICATION_DATA
WLAN_PHY_RADIO_STATE
WLAN_NOTIFICATION_CALLBACK
Native Wi-Fi Reference