Сканкод · дистрибьютор в РФ и СНГwln_start()
Этот раздел сейчас находится в стадии переработки. Приносим извинения за неудобство. Если вам нужна срочная помощь, обратитесь в службу поддержки Tibbo.
| Описание: | Процедура API, запускает попытки поднять (загрузить) интерфейс Wi-Fi, найти указанную беспроводную сеть и подключиться к ней, а затем поддерживать подключение постоянно. |
| Синтаксис: | wln_start(byref ap_name as string, security_mode as pl_wln_security_modes, byref key as string, domain as pl_wln_domains) as en_wln_status_codes |
| Возвращает: | Одно из значений en_wln_status_codes: WLN_STATUS_OK, WLN_STATUS_OUT_OF_SOCKETS, WLN_STATUS_INSUFFICIENT_BUFFER_SPACE, WLN_STATUS_MISSING_FIRMWARE_FILE, WLN_STATUS_BOOT_FAILURE, WLN_STATUS_INVALID_SECURITY_MODE, WLN_STATUS_INVALID_WEP_KEY |
| См. также: | Пошаговая инструкция по использованию, Подробности работы, Простейший пример |
| Параметр | Описание |
| 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 здесь задаётся предварительно разделяемый мастер-ключ, а не «человеческий» пароль. Ключ можно вычислить с помощью wln_wpa_mkey_get(). |
| domain | Задаёт набор каналов, на которых будет работать интерфейс Wi-Fi. Возможные значения: 0- PL_WLN_DOMAIN_FCC (по умолчанию): домен FCC (США). Разрешённые каналы: 1-11. 1- PL_WLN_DOMAIN_EU: Европейский союз. Разрешённые каналы: 1-13. 2- PL_WLN_DOMAIN_JAPAN: Япония. Разрешённые каналы: 1-14. 3- PL_WLN_DOMAIN_OTHER: все остальные страны. Разрешённые каналы: 1-11. |
Подробности
Библиотека WLN работает без блокировки. Wln_start() быстро возвращает управление вашему приложению, а остальная работа библиотеки продолжается в фоновом режиме.
Библиотека WLN использует активное сканирование (wln.activescan), поэтому может находить точки доступа, которые не транслируют свои SSID.
Если в зоне действия несколько точек доступа с одинаковым SSID, библиотека WLN автоматически выберет точку доступа с самым сильным сигналом.