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