WLAN_NOTIFICATION_CALLBACK回调函数 (wlanapi.h)
WLAN_NOTIFICATION_CALLBACK回调函数原型定义通知回调函数的类型。
语法
WLAN_NOTIFICATION_CALLBACK WlanNotificationCallback;
void WlanNotificationCallback(
PWLAN_NOTIFICATION_DATA unnamedParam1,
PVOID unnamedParam2
)
{...}
参数
unnamedParam1
指向包含通知信息的 WLAN_NOTIFICATION_DATA 结构的指针。
带 SP3 的 Windows XP 和适用于 SP2 的 Windows XP 无线 LAN API： 仅提供wlan_notification_acm_connection_complete和wlan_notification_acm_disconnected通知。
unnamedParam2
指向客户端在注册通知时提供的上下文信息的指针。
返回值
无
备注
应用程序使用 WlanRegisterNotification 函数在所有无线接口上注册和注销通知。 注册通知时，应用程序必须提供传递给 WlanRegisterNotification 函数的 funcCallback 参数指向的回调函数。 此回调函数的原型是 WLAN_NOTIFICATION_CALLBACK。 此回调函数将接收已在传递给 WlanRegisterNotification 函数的 dwNotifSource 参数中注册的通知。
回调函数是使用指向 WLAN_NOTIFICATION_DATA 结构的指针作为包含通知详细信息的第一个参数调用的。 回调函数还接收第二个参数，该参数包含指向在 pCallbackContext 参数中传递给 WlanRegisterNotification 函数的客户端上下文的指针。 如果此客户端上下文是传递给 WlanRegisterNotification 函数的内容，则此客户端上下文可以是 NULL 指针。
注册后，只要有通知可用，就会调用回调函数，直到客户端注销或关闭句柄。
如果调用应用程序通过使用用于向 WlanRegisterNotification 函数注册通知的 hClientHandle 参数) 调用 WlanCloseHandle 来关闭其调用句柄 (，则接收通知的任何注册都会自动撤消，或者进程结束。
如果回调函数收到的WLAN_NOTIFICATION_DATA结构的 NotificationSource 成员WLAN_NOTIFICATION_SOURCE_ACM，则收到的通知是自动配置模块通知。 传递给 WLAN_NOTIFICATION_CALLBACK 函数的WLAN_NOTIFICATION_DATA 结构的 NotificationCode 成员确定WLAN_NOTIFICATION_DATA结构的 pData 成员的解释。 有关这些通知的详细信息，请参阅 WLAN_NOTIFICATION_ACM 枚举参考。
如果回调函数收到的WLAN_NOTIFICATION_DATA结构的 NotificationSource 成员WLAN_NOTIFICATION_SOURCE_HNWK，则收到的通知是在安装了无线 LAN 服务的 Windows 7 和 Windows Server 2008 R2 上支持的无线托管网络通知。 传递给 WLAN_NOTIFICATION_CALLBACK 函数的WLAN_NOTIFICATION_DATA 结构的 NotificationCode 成员确定WLAN_NOTIFICATION_DATA结构的 pData 成员的解释。 有关这些通知的详细信息，请参阅 WLAN_HOSTED_NETWORK_NOTIFICATION_CODE 枚举参考。
如果回调函数收到的WLAN_NOTIFICATION_DATA结构的 NotificationSource 成员WLAN_NOTIFICATION_SOURCE_IHV，则收到的通知是独立硬件供应商， (IHV) 通知。 传递给 WLAN_NOTIFICATION_CALLBACK 函数的WLAN_NOTIFICATION_DATA 结构的 NotificationCode 成员确定WLAN_NOTIFICATION_DATA结构的 pData 成员的解释，该成员特定于 IHV。
如果回调函数收到的 WLAN_NOTIFICATION_DATA 结构的 NotificationSource 成员WLAN_NOTIFICATION_SOURCE_ONEX，则收到的通知是 802.1X 模块通知。 传递给 WLAN_NOTIFICATION_CALLBACK 函数的WLAN_NOTIFICATION_DATA 结构的 NotificationCode 成员确定WLAN_NOTIFICATION_DATA结构的 pData 成员的解释。 有关这些通知的详细信息，请参阅 ONEX_NOTIFICATION_TYPE 枚举参考。
如果回调函数收到的WLAN_NOTIFICATION_DATA结构的 NotificationSource 成员WLAN_NOTIFICATION_SOURCE_MSM，则收到的通知是特定于媒体的模块， (MSM) 通知。 传递给 WLAN_NOTIFICATION_CALLBACK 函数的WLAN_NOTIFICATION_DATA 结构的 NotificationCode 成员确定WLAN_NOTIFICATION_DATA结构的 pData 成员的解释。 有关这些通知的详细信息，请参阅 WLAN_NOTIFICATION_MSM 枚举参考。
如果回调函数收到的WLAN_NOTIFICATION_DATA结构的 NotificationSource 成员WLAN_NOTIFICATION_SOURCE_SECURITY，则收到的通知是安全通知。 当前没有为 WLAN_NOTIFICATION_SOURCE_SECURITY定义通知。
带 SP3 的 Windows XP 和适用于 SP2 的 Windows XP 无线 LAN API： 通知由 Netman 服务处理。 如果 Netman 服务已禁用或不可用，将不会收到通知。 如果在合理的时间段内未收到通知，应用程序应超时并查询当前接口状态。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows Vista、Windows XP SP3 [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | wlanapi.h |
| 可再发行组件 | 带有 SP2 的 Windows XP 无线 LAN API |