Udostępnij za pośrednictwem

Funkcja WifiConfig_GetNetworkIdByConfigName

  • Artykuł

Nagłówek: #include <applibs/wificonfig.h>

Pobiera identyfikator sieci dla konfiguracji sieci o podanej nazwie. Użyj WifiConfig_SetConfigName , aby przypisać nazwę sieci. Identyfikator sieci może ulec zmianie w miarę dodawania i usuwania konfiguracji sieci, więc aplikacje powinny ponownie uzyskać identyfikator sieci przed zmianą przechowywanej konfiguracji sieci.

int WifiConfig_GetNetworkIdByConfigName(const char *configName);

Parametry

  • configName Wskaźnik do nazwy konfiguracji sieci. Ta nazwa została ustawiona przy użyciu WifiConfig_SetConfigName. Ciąg musi być zakończony wartością NULL i być mniejszy lub równy bajtom WIFICONFIG_CONFIG_NAME_MAX_LENGTH (z wyłączeniem zakończenia).

Błędy

Zwraca wartość -1 w przypadku napotkania błędu i ustawia errno wartość błędu.

  • EACCES: manifest aplikacji nie zawiera funkcji WifiConfig.

  • EFAULT: configName parametr ma wartość NULL.

  • ERANGE: configName parametr jest większy niż WIFICONFIG_SSID_MAX_LENGTH.

  • EAGAIN: urządzenie Wi-Fi nie jest gotowe.

  • ENETDOWN: Wi-Fi interfejs sieciowy jest niedostępny.

  • ENODEV: nie można odnaleźć określonej konfiguracji sieci.

Mogą być również określone inne errno błędy; takie błędy nie są deterministyczne i to samo zachowanie może nie być zachowane za pośrednictwem aktualizacji systemu.

Zwracana wartość

Zwraca identyfikator sieci określonej sieci (wartość nie ujemna) lub -1 dla niepowodzenia, w którym to przypadku errno jest ustawiona wartość błędu. Identyfikator sieci jest przekazywany do funkcji WifiConfig_Setxxx jako identyfikator skonfigurowanej sieci.

Wymagania dotyczące manifestu aplikacji

Manifest aplikacji musi zawierać funkcję WifiConfig.