WLAN_NOTIFICATION_CALLBACK回调函数 (wlanapi.h)

项目
03/04/2024

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