wlanapi.h) (WLAN_CONNECTION_NOTIFICATION_DATA 结构
WLAN_CONNECTION_NOTIFICATION_DATA结构包含有关连接相关通知的信息。
语法
typedef struct _WLAN_CONNECTION_NOTIFICATION_DATA {
WLAN_CONNECTION_MODE wlanConnectionMode;
WCHAR strProfileName[WLAN_MAX_NAME_LENGTH];
DOT11_SSID dot11Ssid;
DOT11_BSS_TYPE dot11BssType;
BOOL bSecurityEnabled;
WLAN_REASON_CODE wlanReasonCode;
DWORD dwFlags;
WCHAR strProfileXml[1];
} WLAN_CONNECTION_NOTIFICATION_DATA, *PWLAN_CONNECTION_NOTIFICATION_DATA;
成员
wlanConnectionMode
一个WLAN_CONNECTION_MODE值，该值指定连接模式。
带 SP3 的 Windows XP 和适用于 SP2 的 Windows XP 无线 LAN API： 仅支持 wlan_connection_mode_profile 值。
strProfileName[WLAN_MAX_NAME_LENGTH]
用于连接的配置文件的名称。 WLAN_MAX_NAME_LENGTH为 256。 配置文件名称区分大小写。 此字符串必须以 NULL 结尾。
dot11Ssid
包含关联的 SSID 的DOT11_SSID 结构。
dot11BssType
指示 BSS 网络类型的 DOT11_BSS_TYPE 值。
bSecurityEnabled
指示是否为此连接启用安全性。 如果 为 TRUE，则启用安全性。
wlanReasonCode
指示操作失败原因 的WLAN_REASON_CODE 。 对于除 wlan_notification_acm_connection_complete 之外的所有与连接相关的通知，此字段的值为 WLAN_REASON_CODE_SUCCESS。 如果连接失败，此字段指示失败的原因。
dwFlags
一组为网络连接提供附加信息的标志。
此成员可以是 在 Wlanapi.h 头文件中定义的以下值之一。
| 值 | 含义 |
|---|---|
|
指示形成临时网络。 |
|
指示连接使用控制台用户拥有的每用户配置文件。 非控制台用户将无法在其配置文件列表中看到该配置文件。 |
strProfileXml[1]
如果连接成功，此字段包含用于发现的配置文件的 XML 表示形式。
注解
应用程序使用 WlanRegisterNotification 函数在所有无线接口上注册和注销通知。 注册通知时，应用程序必须提供传递给 WlanRegisterNotification 函数的 funcCallback 参数指向的回调函数。 此回调函数的原型是 WLAN_NOTIFICATION_CALLBACK。 此回调函数将接收已在传递给 WlanRegisterNotification 函数的 dwNotifSource 参数中注册的通知。
回调函数是使用指向 WLAN_NOTIFICATION_DATA 结构的指针作为包含通知详细信息的第一个参数调用的。
如果回调函数收到的WLAN_NOTIFICATION_DATA结构的 NotificationSource 成员WLAN_NOTIFICATION_SOURCE_ACM，则收到的通知是自动配置模块通知。 传递给 WLAN_NOTIFICATION_CALLBACK 函数的WLAN_NOTIFICATION_DATA 结构的 NotificationCode 成员确定WLAN_NOTIFICATION_DATA结构的 pData 成员的解释。 对于其中一些通知， WLAN_NOTIFICATION_DATA 结构的 pData 成员中返回 WLAN_CONNECTION_NOTIFICATION_DATA 结构。
有关这些通知的详细信息，请参阅 WLAN_NOTIFICATION_ACM 枚举参考。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows Vista、Windows XP SP3 [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
| 标头 | wlanapi.h |
| 可再发行组件 | 带有 SP2 的 Windows XP 无线 LAN API |