WLAN_NOTIFICATION_CALLBACK wlanapi.h (回呼函式)
WLAN_NOTIFICATION_CALLBACK回呼函式原型會定義通知回呼函式的類型。
語法
WLAN_NOTIFICATION_CALLBACK WlanNotificationCallback;
void WlanNotificationCallback(
PWLAN_NOTIFICATION_DATA unnamedParam1,
PVOID unnamedParam2
)
{...}
參數
unnamedParam1
包含通知資訊的 WLAN_NOTIFICATION_DATA 結構的指標。
Windows XP with SP3 和 Wireless LAN API for Windows XP with SP2： 只有wlan_notification_acm_connection_complete和wlan_notification_acm_disconnected通知可用。
unnamedParam2
用戶端註冊通知時所提供之內容資訊的指標。
傳回值
無
備註
WlanRegisterNotification 函式是由應用程式用來在所有無線介面上註冊和取消註冊通知。 註冊通知時，應用程式必須提供傳遞至 WlanRegisterNotification 函式的 funcCallback 參數指向的回呼函式。 此回呼函式的原型是 WLAN_NOTIFICATION_CALLBACK。 此回呼函式會收到已向 WlanRegisterNotification 函式傳遞之 dwNotifSource 參數中註冊的通知。
呼叫回呼函式時，會以 WLAN_NOTIFICATION_DATA 結構的指標作為包含通知詳細資訊的第一個參數。 回呼函式也會接收第二個參數，其中包含傳遞至 WlanRegisterNotification 函式之 pCallbackContext 參數中用戶端內容的指標。 如果這是傳遞給 WlanRegisterNotification 函式的內容，則此用戶端內容可以是 NULL 指標。
註冊之後，每當有通知可用時，就會呼叫回呼函式，直到用戶端取消註冊或關閉句柄為止。
如果呼叫 (應用程式使用 hClientHandle 參數呼叫 WlanCloseHandle，) 用來向 WlanRegisterNotification 函式註冊通知，或進程結束時，呼叫 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，則收到的通知是 Windows 7 和 Windows Server 2008 R2 上已安裝無線 LAN 服務的無線託管網路通知。 傳遞至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定義任何通知。
Windows XP with SP3 和 Wireless LAN API for Windows XP with SP2： Netman 服務會處理通知。 如果 Netman 服務已停用或無法使用，將不會收到通知。 如果未在合理的時間內收到通知，應用程式應該逾時並查詢目前的介面狀態。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista、Windows XP SP3 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | wlanapi.h |
| 可轉散發套件 | Windows XP 搭配 SP2 的無線 LAN API |