Applibs wificonfig.h
Заголовок: #include <applibs/wificonfig.h>
Заголовок Applibs wificonfig содержит функции и типы, которые управляют конфигурациями сети Wi-Fi на устройстве.
Примечание
Чтобы использовать эти функции, определите WIFICONFIG_STRUCTS_VERSION с используемой версией структуры. В настоящее время единственной допустимой версией является 1 (определите WIFICONFIG_STRUCTS_VERSION 1). После этого можно использовать понятные имена WifiConfig_ структур, которые начинаются с WifiConfig_.
Требования к манифесту приложения
Эти функции можно вызывать только в том случае, если в манифесте приложения есть возможность WifiConfig. Функция EnterpriseWifiConfig также требуется, если приложение управляет любыми параметрами для сети EAP-TLS.
Потокобезопасность
Эти функции не являются потокобезопасны.
Основные понятия и примеры
- Подключение Azure Sphere к Wi-Fi
- Пример: Wi-Fi
- Пример. Эталонное решение для настройки Wi-Fi на основе BLE и управления устройствами
Функции
| Функции | Описание |
|---|---|
| WifiConfig_AddNetwork | Добавляет Wi-Fi сеть на устройство и возвращает идентификатор сети. |
| WifiConfig_AddDuplicateNetwork | Добавляет новую сеть, которая является дубликатом существующей сети. |
| WifiConfig_ForgetAllNetworks | Удаляет все сохраненные Wi-Fi сети с устройства. Отключает устройство от любой подключенной сети. |
| WifiConfig_ForgetNetwork | Устаревшие: Эта функция устарела. Вместо этого используйте WifiConfig_ForgetNetworkById . |
| WifiConfig_ForgetNetworkById | Удаляет Wi-Fi сеть с устройства. |
| WiFiConfig_GetClientCertStoreIdentifier | Возвращает идентификатор хранимого сертификата клиента для сети. |
| WiFiConfig_GetClientIdentity | Возвращает удостоверение клиента сети. |
| WifiConfig_GetConnectedNetworkId | Возвращает идентификатор подключенной в данный момент сети. |
| WifiConfig_GetCurrentNetwork | Возвращает Wi-Fi сеть, подключенную к устройству. |
| WifiConfig_GetNetworkDiagnostics | Возвращает сведения о последнем сбое сети. |
| WifiConfig_GetNetworkIdByConfigName | Возвращает идентификатор сети для конфигурации сети с заданным именем. |
| WiFiConfig_GetRootCACertStoreIdentifier | Возвращает идентификатор хранимого сертификата корневого ЦС для сети. |
| WifiConfig_GetScannedNetworks | Возвращает Wi-Fi сети, обнаруженные последней операцией сканирования. |
| WifiConfig_GetStoredNetworkCount | Возвращает количество сохраненных Wi-Fi сетей на устройстве. |
| WifiConfig_GetStoredNetworks | Извлекает все сохраненные Wi-Fi сети на устройстве. |
| WifiConfig_PersistConfig | Записывает текущую конфигурацию сети в неизменяемое хранилище, чтобы она сохранялась при перезагрузке устройства. |
| WifiConfig_ReloadConfig | Перезагружает конфигурацию Wi-Fi. |
| WiFiConfig_SetClientCertStoreIdentifier | Задает идентификатор хранимого сертификата клиента для сети. |
| WiFiConfig_SetClientIdentity | Задает удостоверение клиента для сети. |
| WifiConfig_SetConfigName | Задает имя конфигурации сети. Имя можно использовать в качестве удобного дескриптора для идентификации конфигурации сети. |
| WifiConfig_SetNetworkEnabled | Включает или отключает конфигурацию сети Wi-Fi. |
| WifiConfig_SetPSK | Задает общий ключ (PSK) для Wi-Fi сети. |
| WiFiConfig_SetRootCACertStoreIdentifier | Задает идентификатор хранимого сертификата корневого ЦС для сети. |
| WifiConfig_SetSecurityType | Задает тип безопасности для Wi-Fi сети. |
| WifiConfig_SetSsid | Задает SSID для Wi-Fi сети. |
| WifiConfig_SetTargetedScanEnabled | Включает или отключает целевое сканирование сети. |
| WifiConfig_StoreOpenNetwork | Устаревшие: Эта функция устарела. Вместо этого используйте WifiConfig_AddNetwork . |
| WifiConfig_StoreWpa2Network | Устаревшие: Эта функция устарела. Вместо этого используйте WifiConfig_AddNetwork . |
| WifiConfig_TriggerScanAndGetScannedNetworkCount | Запускает проверку для поиска всех доступных Wi-Fi сетей. |
Структуры
| Структура | Описание |
|---|---|
| WifiConfig_ClientIdentify | Удостоверение клиента, связанное с сетью. |
| WifiConfig_ConnectedNetwork | Свойства подключенной сети Wi-Fi, представляющей базовый набор служб (BSS) 802.11. |
| WifiConfig_NetworkDiagnostics | Сведения о последнем сбое подключения к сети. |
| WifiConfig_ScannedNetwork | Свойства отсканированной сети Wi-Fi, представляющей BSS 802.11. |
| WifiConfig_StoredNetwork | Свойства хранимой Wi-Fi сети, представляющей BSS 802.11. |
Перечисления
| Перечисления | Описание |
|---|---|
| WifiConfig_Security | Параметр ключа безопасности для Wi-Fi сети. |
Typedef
| Typedef | Описание |
|---|---|
| WifiConfig_Security_Type | Указывает тип значений параметров безопасности для перечисления WifiConfig_Security . |