WLAN_HOSTED_NETWORK_NOTIFICATION_CODE wlanapi.) h (列舉

發行項
03/13/2024

WLAN_HOSTED_NETWORK_NOTIFICATION_CODE列舉型別會指定無線託管網路上所接收通知的 NotificationCode 參數可能值。

Syntax

typedef enum _WLAN_HOSTED_NETWORK_NOTIFICATION_CODE {
  wlan_hosted_network_state_change,
  wlan_hosted_network_peer_state_change,
  wlan_hosted_network_radio_state_change
} WLAN_HOSTED_NETWORK_NOTIFICATION_CODE, *PWLAN_HOSTED_NETWORK_NOTIFICATION_CODE;

常數


`wlan_hosted_network_state_change` 裝載的網路狀態已變更。
`wlan_hosted_network_peer_state_change` 託管的網路對等狀態已變更。
`wlan_hosted_network_radio_state_change` 託管網路無線電狀態已變更。

備註

WLAN_HOSTED_NETWORK_NOTIFICATION_CODE列舉類型是新增的原生無線 API 擴充功能，可支援 Windows 7 上的無線託管網路，以及已安裝無線 LAN 服務的 Windows Server 2008 R2。

當無線託管網路上的 NotificationSource 參數WLAN_NOTIFICATION_SOURCE_HNWK時， WLAN_HOSTED_NETWORK_NOTIFICATION_CODE 指定所接收通知的 NotificationCode 參數可能的值。

WLAN_HOSTED_NETWORK_NOTIFICATION_CODE列舉的起始值會定義為 L2_NOTIFICATION_CODE_V2_BEGIN，其定義於 l2cmn.h 頭檔中。請注意，wlanapi.h 頭文件會自動包含 l2cmn.h 標頭。

WlanRegisterNotification 函式是由應用程式用來在所有無線介面上註冊和取消註冊通知。註冊通知時，應用程式必須提供傳遞給 WlanRegisterNotification 函式的 funcCallback 參數所指向的回呼函式。此回呼函式的原型是 WLAN_NOTIFICATION_CALLBACK。此回呼函式會收到已在傳遞至 WlanRegisterNotification 函式的 dwNotifSource 參數中註冊的通知。

回呼函式會使用 WLAN_NOTIFICATION_DATA 結構的指標呼叫，做為包含通知詳細資訊的第一個參數。回呼函式也會接收第二個參數，其中包含 pCallbackContext 參數傳遞給 WlanRegisterNotification 函式之用戶端內容的指標。如果這是傳遞至 WlanRegisterNotification 函式的內容，此用戶端內容可以是 NULL 指標。

如果回呼函式所接收之WLAN_NOTIFICATION_DATA結構的 NotificationSource 成員WLAN_NOTIFICATION_SOURCE_HNWK，則收到的通知是無線託管網路通知。傳遞至WLAN_NOTIFICATION_CALLBACK函式之WLAN_NOTIFICATION_DATA結構的 NotificationCode 成員會決定WLAN_NOTIFICATION_DATA結構的 pData 成員解譯。

NotificationCode	Description
wlan_hosted_network_state_change	WLAN_NOTIFICATION_DATA 結構的 pData 成員應該轉換成WLAN_HOSTED_NETWORK_STATE_CHANGE結構的指標，而 dwDataSize 成員的大小至少會與WLAN_HOSTED_NETWORK_STATE_CHANGE WLAN_HOSTED_NETWORK_STATE_CHANGE) (的大小相同。
wlan_hosted_network_peer_state_change	WLAN_NOTIFICATION_DATA 結構的 pData 成員應該轉換成WLAN_HOSTED_NETWORK_DATA_PEER_STATE_CHANGE結構的指標，而 dwDataSize 成員的大小至少會與 (WLAN_HOSTED_NETWORK_DATA_PEER_STATE_CHANGE) 相同。
wlan_hosted_network_radio_state_change	WLAN_NOTIFICATION_DATA 結構的 pData 成員應該轉換成WLAN_HOSTED_NETWORK_RADIO_STATE結構的指標，而 dwDataSize 成員的大小至少會與 (WLAN_HOSTED_NETWORK_RADIO_STATE ) 相同。

規格需求

需求	值
最低支援的用戶端	Windows 7 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 R2 [僅限傳統型應用程式]
標頭	wlanapi.h (包含 Wlanapi.h)