WLAN_CONNECTION_NOTIFICATION_DATA結構 (wlanapi.h)
WLAN_CONNECTION_NOTIFICATION_DATA 結構包含連線相關通知的相關信息。
語法
typedef struct _WLAN_CONNECTION_NOTIFICATION_DATA {
WLAN_CONNECTION_MODE wlanConnectionMode;
WCHAR strProfileName[WLAN_MAX_NAME_LENGTH];
DOT11_SSID dot11Ssid;
DOT11_BSS_TYPE dot11BssType;
BOOL bSecurityEnabled;
WLAN_REASON_CODE wlanReasonCode;
DWORD dwFlags;
WCHAR strProfileXml[1];
} WLAN_CONNECTION_NOTIFICATION_DATA, *PWLAN_CONNECTION_NOTIFICATION_DATA;
成員
wlanConnectionMode
指定連接模式 的WLAN_CONNECTION_MODE 值。
Windows XP with SP3 和 Wireless LAN API for Windows XP with SP2： 僅支援 wlan_connection_mode_profile 值。
strProfileName[WLAN_MAX_NAME_LENGTH]
用於連線的配置檔名稱。 WLAN_MAX_NAME_LENGTH為 256。 配置檔名稱會區分大小寫。 此字串必須以 NULL 終止。
dot11Ssid
包含關聯之 SSID 的DOT11_SSID 結構。
dot11BssType
指出 BSS 網路類型的 DOT11_BSS_TYPE 值。
bSecurityEnabled
指出是否為此連線啟用安全性。 如果為 TRUE，則會啟用安全性。
wlanReasonCode
指出作業失敗原因 的WLAN_REASON_CODE 。 除了 wlan_notification_acm_connection_complete 以外，此字段具有所有連線相關通知 的 WLAN_REASON_CODE_SUCCESS 值。 如果連線失敗，此欄位會指出失敗的原因。
dwFlags
一組旗標，提供網路連線的其他資訊。
這個成員可以是 Wlanapi.h 頭檔中定義的下列其中一個值。
| 值 | 意義 |
|---|---|
|
表示已形成臨機操作網路。 |
|
表示連線使用主控台使用者所擁有的個別使用者配置檔。 非主控台使用者將無法在其設定檔案清單中看到配置檔。 |
strProfileXml[1]
如果連線成功，此欄位會包含用於探索之配置檔的 XML 呈現。
備註
WlanRegisterNotification 函式是由應用程式用來在所有無線介面上註冊和取消註冊通知。 註冊通知時，應用程式必須提供傳遞至 WlanRegisterNotification 函式的 funcCallback 參數指向的回呼函式。 此回呼函式的原型是 WLAN_NOTIFICATION_CALLBACK。 此回呼函式會收到已向 WlanRegisterNotification 函式傳遞之 dwNotifSource 參數中註冊的通知。
呼叫回呼函式時，會以 WLAN_NOTIFICATION_DATA 結構的指標作為包含通知詳細資訊的第一個參數。
如果回呼函式所接收WLAN_NOTIFICATION_DATA結構的 NotificationSource 成員WLAN_NOTIFICATION_SOURCE_ACM，則收到的通知是自動設定模組通知。 傳遞至WLAN_NOTIFICATION_CALLBACK函式之WLAN_NOTIFICATION_DATA結構的 NotificationCode 成員會決定WLAN_NOTIFICATION_DATA結構的 pData 成員解譯。 針對其中一些通知，WLAN_CONNECTION_NOTIFICATION_DATA結構會在 WLAN_NOTIFICATION_DATA 結構的 pData 成員中傳回。
如需這些通知的詳細資訊，請參閱 WLAN_NOTIFICATION_ACM 列舉參考。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista、Windows XP SP3 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
| 標頭 | wlanapi.h |
| 可轉散發套件 | Windows XP 搭配 SP2 的無線 LAN API |