Sdílet prostřednictvím

WifiConfig_GetNetworkIdByConfigName funkce

  • Článek

Hlavička: #include <applibs/wificonfig.h>

Získá ID sítě pro konfiguraci sítě se zadaným názvem. K přiřazení názvu sítě použijte WifiConfig_SetConfigName . ID sítě se může změnit s tím, jak se přidávají a odebírají konfigurace sítě, takže aplikace by měly ID sítě před změnou uložené konfigurace sítě znovu získat.

int WifiConfig_GetNetworkIdByConfigName(const char *configName);

Parametry

  • configName Ukazatel na název konfigurace sítě. Tento název byl nastaven pomocí WifiConfig_SetConfigName. Řetězec musí mít ukončenou hodnotu NULL a musí být menší než nebo roven WIFICONFIG_CONFIG_NAME_MAX_LENGTH bajtům (s výjimkou ukončení).

Chyby

Vrátí hodnotu -1, pokud dojde k chybě, a nastaví errno se na chybovou hodnotu.

  • EACCES: Manifest aplikace neobsahuje funkci WifiConfig.

  • EFAULT: configName Parametr je NULL.

  • ERANGE: configName parametr je větší než WIFICONFIG_SSID_MAX_LENGTH.

  • EAGAIN: zařízení Wi-Fi není připravené.

  • ENETDOWN: Wi-Fi síťové rozhraní není k dispozici.

  • ENODEV: Zadaná konfigurace sítě nebyla nalezena.

Je také možné zadat všechny ostatní errno chyby. Tyto chyby nejsou deterministické a stejné chování nemusí být zachováno prostřednictvím aktualizací systému.

Vrácená hodnota

Vrátí ID sítě zadané sítě (nezáporná hodnota) nebo hodnotu -1 pro selhání. V tomto případě errno je nastavená na chybovou hodnotu. ID sítě se předá WifiConfig_Setxxx funkcím jako identifikátor pro konfiguraci sítě.

Požadavky manifestu aplikace

Manifest aplikace musí obsahovat funkci WifiConfig.