WLAN_NOTIFICATION_CALLBACK wlanapi.h (回呼函式)

發行項
03/09/2024

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