Поделиться через

структура 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 с пакетом обновления 3 (SP3) и API беспроводной локальной сети для Windows XP с пакетом обновления 2 (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 с пакетом обновления 3 (SP3) и API беспроводной локальной сети для Windows XP с пакетом обновления 2 (SP2): Профиль должен соответствовать критериям совместимости, описанным в разделе Совместимость профилей беспроводной сети.

pDot11Ssid

Указатель на структуру DOT11_SSID , указывающую SSID сети для подключения. Этот параметр является необязательным. Если задано значение NULL, будут проверены все идентификаторы SSID в профиле. Этот параметр не должен иметь значение NULL, если WLAN_CONNECTION_MODE имеет значение wlan_connection_mode_discovery_secure или wlan_connection_mode_discovery_unsecure.

pDesiredBssidList

Указатель на структуру DOT11_BSSID_LIST , содержащую список идентификаторов базового набора служб (BSS), необходимых для подключения.

Windows XP с пакетом обновления 3 (SP3) и API беспроводной локальной сети для Windows XP с пакетом обновления 2 (SP2): Этот элемент должен иметь значение NULL.

dot11BssType

Значение DOT11_BSS_TYPE , указывающее тип BSS сети. Если указан профиль, этот тип BSS должен совпадать с типом в профиле.

dwFlags

В следующей таблице показаны флаги, используемые для указания параметров подключения.

Константа Значение Описание
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 из шифрования и расшифровки. Этот флаг используется, когда приложение должно отправлять трафик EAPOL через инфраструктурную сеть, которая использует открытую проверку подлинности и шифрование WEP. Этот флаг не следует использовать для подключения к сетям, требующим проверки подлинности 802.1X. Этот флаг действителен, только если параметру wlanConnectionMode присвоено значение wlan_connection_mode_temporary_profile. По возможности старайтесь не использовать этот флаг.
WLAN_CONNECTION_PERSIST_DISCOVERY_PROFILE 0x00000010 Автоматически сохранять профиль обнаружения при успешном завершении подключения. Этот флаг действителен только для wlan_connection_mode_discovery_secure или wlan_connection_mode_discovery_unsecure. Профиль будет сохранен как профиль всех пользователей с именем, созданным из SSID с помощью WlanUtf8SsidToDisplayName. Если профиль с таким же именем уже существует, в конец имени профиля будет добавлен номер. Профиль будет сохранен в режиме ручного подключения, если не указан 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 с пакетом обновления 3 (SP3) и API беспроводной локальной сети для Windows XP с пакетом обновления 2 (SP2): Для этого элемента должно быть задано значение 0.

Требования

Требование Значение
Минимальная версия клиента Windows Vista, Windows XP с пакетом обновления 3 (SP3) [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Верхняя часть wlanapi.h
Распространяемые компоненты API беспроводной локальной сети для Windows XP с пакетом обновления 2 (SP2)

См. также раздел

WlanConnect