WLAN_CONNECTION_PARAMETERS結構 (wlanapi.h)

WLAN_CONNECTION_PARAMETERS 結構會指定使用 WlanConnect 函式時所使用的參數。

語法

typedef struct _WLAN_CONNECTION_PARAMETERS {
  WLAN_CONNECTION_MODE wlanConnectionMode;
#if ...
  LPCWSTR              strProfile;
#else
  LPCWSTR              strProfile;
#endif
  PDOT11_SSID          pDot11Ssid;
  PDOT11_BSSID_LIST    pDesiredBssidList;
  DOT11_BSS_TYPE       dot11BssType;
  DWORD                dwFlags;
} WLAN_CONNECTION_PARAMETERS, *PWLAN_CONNECTION_PARAMETERS;

成員

wlanConnectionMode

指定連線模式 的WLAN_CONNECTION_MODE 值。

Windows XP 搭配 SP3 和適用於 Windows XP 的無線 LAN API 與 SP2： 僅支援 wlan_connection_mode_profile 值。

strProfile

指定用於連線的配置檔。

如果 wlanConnectionMode 設定為 wlan_connection_mode_profile，strProfile 會指定用於連線的配置檔名稱。 如果 wlanConnectionMode 設定為 wlan_connection_mode_temporary_profile，strProfile 會指定用於連線之配置檔的 XML 表示。 如果 wlanConnectionMode 設定為 wlan_connection_mode_discovery_secure 或 wlan_connection_mode_discovery_unsecure， 則 strProfile 應該設定為 NULL。

Windows XP 搭配 SP3 和適用於 Windows XP 的無線 LAN API 與 SP2： 配置文件必須符合 無線配置檔相容性中所述的相容性準則。

pDot11Ssid

DOT11_SSID 結構的指標，指定要連線之網路的 SSID。 這是選擇性參數。 當設定為 NULL 時，將會嘗試設定檔中的所有 SSD。 如果WLAN_CONNECTION_MODE設定為 wlan_connection_mode_discovery_secure 或 wlan_connection_mode_discovery_unsecure，此參數不得為 NULL。

pDesiredBssidList

DOT11_BSSID_LIST 結構的指標 ，其中包含連線所需的基本服務集清單 (BSS) 標識符清單。

Windows XP 搭配 SP3 和適用於 Windows XP 的無線 LAN API 與 SP2： 這個成員必須是 NULL。

dot11BssType

指出網路的 BSS 類型 DOT11_BSS_TYPE 值。 如果提供設定檔，此 BSS 類型必須與設定檔中的設定檔相同。

dwFlags

下表顯示用來指定連接參數的旗標。

常數	值	Description
WLAN_CONNECTION_HIDDEN_NETWORK	0x00000001	即使目的地是隱藏的網路，仍會連線到目的地網路。 隱藏的網路不會廣播其 SSID。 如果目的地網路是臨機操作網路，請勿使用此旗標。如果 strProfile 指定的配置檔不是 NULL，則會忽略此旗標， 而 nonBroadcast 配置檔元素會判斷是否要連線到隱藏的網路。
WLAN_CONNECTION_ADHOC_JOIN_ONLY	0x00000002	請勿形成臨機操作網路。 只有在網路已經存在時，才加入臨機操作網路。 如果目的地網路是基礎結構網路，請勿使用此旗標。
WLAN_CONNECTION_IGNORE_PRIVACY_BIT	0x00000004	線上到網路時忽略隱私權位。 忽略隱私權位的效果是忽略封包是否已加密，以及忽略所使用的加密方法。 只有在使用暫存配置檔連線到基礎結構網路時，才使用此旗標。
WLAN_CONNECTION_EAPOL_PASSTHROUGH	0x00000008	免除 EAPOL 流量的加密和解密。 當應用程式必須透過使用開放式驗證和 WEP 加密的基礎結構網路傳送 EAPOL 流量時，就會使用此旗標。 此旗標不得用來連線到需要 802.1X 驗證的網路。 只有當 wlanConnectionMode 設定為 wlan_connection_mode_temporary_profile時，此旗標才有效。 請盡可能避免使用此旗標。
WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE	0x00000010	在連線成功完成時自動保存探索配置檔。 此旗標僅適用於wlan_connection_mode_discovery_secure或wlan_connection_mode_discovery_unsecure。 配置檔會儲存為所有使用者配置檔，其名稱會使用 WlanUtf8SsidToDisplayName 從 SSID 產生。 如果已經有具有相同名稱的配置檔，則會將數位附加至配置檔名稱的結尾。 除非同時指定WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE_CONNECTION_MODE_AUTO，否則配置檔會以手動連線模式儲存。
WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE_CONNECTION_MODE_AUTO	0x00000020	要與WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE搭配使用。 探索配置檔會以自動連線模式保存。
WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE_OVERWRITE_EXISTING	0x00000040	要與WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE搭配使用。 探索配置檔將會保存，並嘗試以相同名稱覆寫現有的配置檔。

 

Windows XP 搭配 SP3 和適用於 Windows XP 的無線 LAN API 與 SP2： 此成員必須設定為 0。

規格需求

需求	值
最低支援的用戶端	Windows Vista、Windows XP 與 SP3 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
標頭	wlanapi.h
可轉散發套件	適用於 Windows XP 與 SP2 的無線 LAN API

另請參閱

WlanConnect