(wlanapi.h) WLAN_MSM_NOTIFICATION_DATA 结构
WLAN_MSM_NOTIFICATION_DATA结构包含有关特定于媒体的模块 (MSM) 连接相关通知的信息。
语法
typedef struct _WLAN_MSM_NOTIFICATION_DATA {
WLAN_CONNECTION_MODE wlanConnectionMode;
WCHAR strProfileName[WLAN_MAX_NAME_LENGTH];
DOT11_SSID dot11Ssid;
DOT11_BSS_TYPE dot11BssType;
DOT11_MAC_ADDRESS dot11MacAddr;
BOOL bSecurityEnabled;
BOOL bFirstPeer;
BOOL bLastPeer;
WLAN_REASON_CODE wlanReasonCode;
} WLAN_MSM_NOTIFICATION_DATA, *PWLAN_MSM_NOTIFICATION_DATA;
成员
wlanConnectionMode
一个WLAN_CONNECTION_MODE值,该值指定连接的模式。
strProfileName[WLAN_MAX_NAME_LENGTH]
用于连接的配置文件的名称。 WLAN_MAX_NAME_LENGTH为 256。 配置文件名称区分大小写。 此字符串必须以 NULL 结尾。
dot11Ssid
包含关联的 SSID 的DOT11_SSID 结构。
dot11BssType
指示 BSS 网络类型的 DOT11_BSS_TYPE 值。
dot11MacAddr
指定对等方或接入点的 MAC 地址的 DOT11_MAC_ADDRESS 。
bSecurityEnabled
指示是否为此连接启用安全性。 如果 为 TRUE,则启用安全性。
bFirstPeer
指示对等方是否是第一个加入计算机创建的临时网络。 如果 为 TRUE,则第一个加入对等方。
第一个对等方加入网络后,创建临时网络的计算机的接口状态从wlan_interface_state_ad_hoc_network_formed更改为wlan_interface_state_connected。
bLastPeer
指示对等方是否是最后一个离开计算机创建的临时网络。 如果 为 TRUE,则最后一个要离开的对等方。 在最后一个对等方离开网络后,创建临时网络的计算机的接口状态从wlan_interface_state_connected更改为wlan_interface_state_ad_hoc_network_formed。
wlanReasonCode
指示操作失败原因 的WLAN_REASON_CODE 。 如果操作成功,则此字段的值为 WLAN_REASON_CODE_SUCCESS。 否则,此字段指示失败的原因。
注解
应用程序使用 WlanRegisterNotification 函数在所有无线接口上注册和取消注册通知。 注册通知时,应用程序必须提供传递给 WlanRegisterNotification 函数的 funcCallback 参数指向的回调函数。 此回调函数的原型是 WLAN_NOTIFICATION_CALLBACK。 此回调函数将接收已在传递给 WlanRegisterNotification 函数的 dwNotifSource 参数中注册的通知。
回调函数使用指向 WLAN_NOTIFICATION_DATA 结构的指针调用,作为包含通知详细信息的第一个参数。
如果回调函数收到的WLAN_NOTIFICATION_DATA结构的 NotificationSource 成员WLAN_NOTIFICATION_SOURCE_MSM,则收到的通知是特定于媒体的模块, (MSM) 通知。 传递给 WLAN_NOTIFICATION_CALLBACK 函数的 WLAN_NOTIFICATION_DATA 结构的 NotificationCode 成员确定WLAN_NOTIFICATION_DATA结构的 pData 成员的解释。 对于其中一些通知,WLAN_MSM_NOTIFICATION_DATA 结构在 WLAN_NOTIFICATION_DATA 结构的 pData 成员中返回。
有关这些通知的详细信息,请参阅 WLAN_NOTIFICATION_MSM 枚举参考。
要求
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
标头 | wlanapi.h |