Share via

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

具有 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