Share via

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 头文件中定义的以下值之一。

值 含义
WLAN_CONNECTION_NOTIFICATION_ADHOC_NETWORK_FORMED
 指示形成临时网络。
WLAN_CONNECTION_NOTIFICATION_CONSOLE_USER_PROFILE
 指示连接使用控制台用户拥有的每用户配置文件。 非控制台用户将无法在其配置文件列表中看到该配置文件。

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

另请参阅

WLAN_NOTIFICATION_ACM

WLAN_NOTIFICATION_CALLBACK

WLAN_NOTIFICATION_DATA

WlanRegisterNotification