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

另請參閱

WLAN_NOTIFICATION_CALLBACK

WLAN_NOTIFICATION_DATA

WLAN_NOTIFICATION_MSM

WlanRegisterNotification