WLAN_CONNECTION_PARAMETERS 结构 (wlanapi.h)

项目
08/28/2023

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值，该值指定连接模式。

具有 SP3 的 Windows XP 和适用于 SP2 的 Windows XP 的无线 LAN API： 仅支持 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。

具有 SP3 的 Windows XP 和适用于 SP2 的 Windows XP 的无线 LAN API： 配置文件必须满足无线配置文件兼容性中所述的兼容性条件。

pDot11Ssid

指向 DOT11_SSID 结构的指针，该结构指定要连接到的网络的 SSID。此参数是可选的。设置为 NULL 时，将尝试配置文件中的所有 SSSD。如果WLAN_CONNECTION_MODE设置为wlan_connection_mode_discovery_secure或wlan_connection_mode_discovery_unsecure，则此参数不得为 NULL。

pDesiredBssidList

指向 DOT11_BSSID_LIST 结构的指针，该结构包含连接所需的基本服务集 (BSS) 标识符的列表。

具有 SP3 的 Windows XP 和适用于 SP2 的 Windows XP 的无线 LAN API： 此成员必须为 NULL。

dot11BssType

指示网络的 BSS 类型的 DOT11_BSS_TYPE 值。如果提供了配置文件，则此 BSS 类型必须与配置文件中的类型相同。

dwFlags

下表显示了用于指定连接参数的标志。

常数	Value	说明
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 一起使用。将保留发现配置文件，并尝试使用同名覆盖现有配置文件。

具有 SP3 的 Windows XP 和适用于 SP2 的 Windows XP 的无线 LAN API： 此成员必须设置为 0。

要求

要求	值
最低受支持的客户端	Windows Vista、Windows XP 和 SP3 [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
标头	wlanapi.h
可再发行组件	适用于 Windows XP 的无线 LAN API SP2

另请参阅

WlanConnect

通过

WLAN_CONNECTION_PARAMETERS 结构 (wlanapi.h)

语法

成员

要求

另请参阅

反馈

其他资源