WLAN_NOTIFICATION_DATA (Compact 7)

Article
08/17/2015

3/12/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.

Partager via

WLAN_NOTIFICATION_DATA (Compact 7)

Syntax

Members

Remarks

See Also

Reference

Ressources supplémentaires