(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

另请参阅

WLAN_NOTIFICATION_CALLBACK

WLAN_NOTIFICATION_DATA

WLAN_NOTIFICATION_MSM

WlanRegisterNotification