Сканкод · дистрибьютор в РФ и СНГwln_change()
Этот раздел сейчас находится в стадии переработки. Приносим извинения за неудобство. Если вам нужна срочная помощь, обратитесь в службу поддержки Tibbo.
| Описание: | Процедура API, задаёт другую целевую беспроводную сеть для библиотеки WLN. |
| Синтаксис: | function wln_change(byref ap_name as string, security_mode as pl_wln_security_modes, byref key as string) as en_wln_status_codes |
| Возвращает: | Одно из значений en_wln_status_codes: WLN_STATUS_OK, WLN_STATUS_NOT_STARTED, WLN_STATUS_INVALID_SECURITY_MODE, WLN_STATUS_INVALID_WEP_KEY, WLN_STATUS_BUSY |
| См. также: | Пошаговая инструкция по использованию, Подробности работы, Роуминг между точками доступа |
| Параметр | Описание |
| ap_name | Новый SSID (имя) беспроводной сети, к которой нужно подключиться. |
| security_mode | Одно из значений pl_wln_security_modes: 0- WLN_SECURITY_MODE_DISABLED, 1- WLN_SECURITY_MODE_WEP64, 2- WLN_SECURITY_MODE_WEP128, 3- WLN_SECURITY_MODE_WPA1 (принимается только при WLN_WPA, равном 1), 4- WLN_SECURITY_MODE_WPA2 (принимается только при WLN_WPA, равном 1) |
| key | Для режима WEP64 - строка из 10 шестнадцатеричных символов (`0`~`9`, `A`~`F` или `a`~`f`). Для режима WEP128 - строка из 26 шестнадцатеричных символов. Для режимов WPA1-PSK и WPA2-PSK здесь задаётся предварительно разделяемый мастер-ключ (pre-shared master key), а не «человеческий» пароль. Ключ можно вычислить с помощью wln_wpa_mkey_get(). |
Подробности
Библиотека WLN работает без блокировки. Wln_change() быстро возвращает управление вашему приложению, а остальная работа библиотеки продолжается в фоновом режиме.
Библиотека WLN использует активное сканирование (wln.activescan), поэтому может находить точки доступа, которые не транслируют свои SSID.
Если в зоне действия несколько точек доступа с одинаковым SSID, библиотека WLN автоматически выберет точку доступа с самым сильным сигналом.
Нельзя использовать эту функцию до вызова wln_start().