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

Метод IDot11AdHocNetwork::Connect (adhoc.h)

  • Статья

Подключается к ранее созданной беспроводной нерегламентированной сети. Прежде чем приложение сможет подключиться к сети, сеть должна быть создана с помощью IDot11AdHocManager::CreateNetwork и зафиксирована с помощью IDot11AdHocManager::CommitCreatedNetwork.

Синтаксис

HRESULT Connect(
  [in] LPCWSTR Passphrase,
  [in] LONG    GeographicalId,
  [in] BOOLEAN fSaveProfile,
  [in] BOOLEAN fMakeSavedProfileUserSpecific
);

Параметры

[in] Passphrase

Строка пароля, используемая для проверки подлинности пользователя или компьютера в сети.

Длина строки пароля зависит от параметров безопасности, передаваемых в параметре pSecurity вызова CreateNetwork . В следующей таблице показана длина пароля, связанная с различными параметрами безопасности.

Параметры безопасности Длина пароля
Open-None 0
Open-WEP 5 или 13 символов; 10 или 26 шестнадцатеричных цифр
WPA2PSK От 8 до 63 символов
 

Перечисленные значения, соответствующие приведенной выше паре параметров безопасности, см. в разделе DOT11_ADHOC_AUTH_ALGORITHM и DOT11_ADHOC_CIPHER_ALGORITHM.

[in] GeographicalId

Географическое расположение, в котором была создана сеть. Список возможных значений см. в разделе Таблица географических расположений.

[in] fSaveProfile

Необязательный параметр, указывающий, следует ли сохранять профиль беспроводной сети. Если задано значение TRUE, профиль сохраняется в хранилище профилей. После сохранения профиля пользователь может изменить профиль с помощью пользовательского интерфейса Управление беспроводной сетью . Профили также можно изменять с помощью собственных функций Wi-Fi.

Сохранение профиля изменяет сетевую сигнатуру, возвращенную IDot11AdHocNetwork::GetSignature.

[in] fMakeSavedProfileUserSpecific

Необязательный параметр, указывающий, является ли сохраняемый профиль профилем всех пользователей. Если задано значение TRUE, профиль зависит от текущего пользователя. Если задано значение FALSE, профиль является профилем всех пользователей и может использоваться любым пользователем, выполнивший вход на компьютер. Этот параметр игнорируется, если fSaveProfile имеет значение FALSE.

По умолчанию только члены группы "Администраторы" могут сохранять профиль всех пользователей. Эти параметры безопасности можно изменить с помощью функции WlanSetSecuritySettings . Приложение должно быть запущено пользователем с достаточными привилегиями для успешного сохранения профиля всех пользователей.

Если приложение выполняется в окне удаленного рабочего стола, можно сохранить только профиль всех пользователей. Профили пользователей не могут быть сохранены в удаленном приложении.

Возвращаемое значение

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

Код возврата Описание
S_OK
 Метод завершился успешно.
E_FAIL
 Сбой метода.
E_INVALIDARG
 Один из параметров недопустим.
E_NOINTERFACE
 Указанный интерфейс не поддерживается.
E_OUTOFMEMORY
 Методу не удалось выделить память, необходимую для выполнения этой операции.
E_POINTER
 Недопустимый указатель, переданный в качестве параметра.

Комментарии

Этот метод является асинхронным. Connect возвращает S_OK немедленно, если параметры, переданные методу, являются допустимыми. Однако код возврата S_OK не указывает на успешность подключения. Чтобы получать уведомления об успешном или неудачном подключении, необходимо зарегистрироваться для получения уведомлений в интерфейсе IDot11AdHocNetworkNotificationSink . Метод IDot11AdHocNetworkNotificationSink::OnStatusChange возвращает состояние подключения. Дополнительные сведения о регистрации для получения уведомлений см. в разделе IDot11AdHocManager.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header adhoc.h

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

IDot11AdHocNetwork

IDot11AdHocNetwork::D isconnect