WLAN_MSM_NOTIFICATION_DATA結構 (wlanapi.h)
WLAN_MSM_NOTIFICATION_DATA結構包含媒體特定模組的相關資訊, (MSM) 連線相關通知。
語法
typedef struct _WLAN_MSM_NOTIFICATION_DATA {
WLAN_CONNECTION_MODE wlanConnectionMode;
WCHAR strProfileName[WLAN_MAX_NAME_LENGTH];
DOT11_SSID dot11Ssid;
DOT11_BSS_TYPE dot11BssType;
DOT11_MAC_ADDRESS dot11MacAddr;
BOOL bSecurityEnabled;
BOOL bFirstPeer;
BOOL bLastPeer;
WLAN_REASON_CODE wlanReasonCode;
} WLAN_MSM_NOTIFICATION_DATA, *PWLAN_MSM_NOTIFICATION_DATA;
成員
wlanConnectionMode
指定連線模式 的WLAN_CONNECTION_MODE 值。
strProfileName[WLAN_MAX_NAME_LENGTH]
用於連線的設定檔名稱。 WLAN_MAX_NAME_LENGTH為 256。 設定檔名稱會區分大小寫。 此字串必須以 Null 結束。
dot11Ssid
包含關聯 SSID 的DOT11_SSID 結構。
dot11BssType
指出 BSS 網路類型的 DOT11_BSS_TYPE 值。
dot11MacAddr
指定對等或存取點之 MAC 位址 的DOT11_MAC_ADDRESS 。
bSecurityEnabled
指出是否為此連線啟用安全性。 如果 為 TRUE,則會啟用安全性。
bFirstPeer
指出對等是否為第一個聯結電腦所建立臨機操作網路。 如果 為 TRUE,對等是第一個要聯結的。
第一個對等聯結網路之後,建立臨機操作網路的電腦介面狀態會從wlan_interface_state_ad_hoc_network_formed變更為wlan_interface_state_connected。
bLastPeer
指出對等是否為最後一個,讓電腦建立的臨機操作網路。 如果 為 TRUE,對等是最後要離開的。 最後一個對等離開網路之後,建立臨機操作網路的電腦介面狀態會從wlan_interface_state_connected變更為wlan_interface_state_ad_hoc_network_formed。
wlanReasonCode
指出作業失敗原因 的WLAN_REASON_CODE 。 如果作業成功,此欄位的值為 WLAN_REASON_CODE_SUCCESS。 否則,此欄位會指出失敗的原因。
備註
WlanRegisterNotification函式是由應用程式用來在所有無線介面上註冊和取消註冊通知。 註冊通知時,應用程式必須提供傳遞給WlanRegisterNotification函式的funcCallback參數所指向的回呼函式。 此回呼函式的原型是 WLAN_NOTIFICATION_CALLBACK。 此回呼函式會收到已在傳遞至WlanRegisterNotification函式的 dwNotifSource參數中註冊的通知。
回呼函式會使用 WLAN_NOTIFICATION_DATA 結構的指標呼叫,做為包含通知詳細資訊的第一個參數。
如果回呼函式所接收之WLAN_NOTIFICATION_DATA結構的NotificationSource成員是WLAN_NOTIFICATION_SOURCE_MSM,則收到的通知是媒體特定模組, (MSM) 通知。 傳遞至WLAN_NOTIFICATION_CALLBACK函式之WLAN_NOTIFICATION_DATA結構的NotificationCode成員會決定WLAN_NOTIFICATION_DATA結構的pData成員解譯。 針對其中一些通知,WLAN_MSM_NOTIFICATION_DATA結構會在WLAN_NOTIFICATION_DATA結構的pData成員中傳回。
如需這些通知的詳細資訊,請參閱 WLAN_NOTIFICATION_MSM 列舉參考。
規格需求
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
標頭 | wlanapi.h |