Share via

WifiConfig_StoreOpenNetwork İşlevi

  • Makale

Üst bilgi: #include <applibs/wificonfig.h>

Önemli

Bu işlev kullanımdan kaldırıldı. Bunun yerine WifiConfig_AddNetwork kullanın.

Açık bir Wi-Fi ağını anahtar olmadan depolar. Bu işlev iş parçacığı güvenli değil.

Aynı ağ cihazda anahtar olmadan zaten depolanıyorsa bu işlev başarısız olur. Hata bölümüne (EEXIST) bakın. Ancak, depolanan bir ağ aynı SSID ile birlikte bir anahtar içeriyorsa, bu işlev başarılı olur ve ağı depolar.

int WifiConfig_StoreOpenNetwork(const uint8_t * ssid, size_t ssidLength);

Parametre

  • ssid Wi-Fi ağı tanımlayan belirtilmemiş karakter kodlamasına sahip bir SSID bayt dizisi işaretçisi.

  • ssidLength Wi-Fi ağının SSID'sindeki bayt sayısı.

Hata

Hatayla karşılaşılırsa ve hata değerine ayarlanırsa errno -1 döndürür.

  • EACCES: Uygulama bildirimi WifiConfig özelliğini içermez.

  • EEXIST: Aynı SSID'ye sahip olan ve anahtar bulunmayan depolanmış bir Wi-Fi ağı.

  • EFAULT: the ssid is NULL.

  • ERANGE: ssidLength 0 veya daha büyük WIFICONFIG_SSID_MAX_LENGTH.

  • EAGAIN: Wi-Fi cihazı henüz hazır değil.

  • ENETDOWN: Wi-Fi ağ arabirimi kullanılamıyor.

  • ENOSPC: Yapılandırmanın kalıcı olması için çok fazla Wi-Fi ağı vardır; kaldırın ve yeniden deneyin.

Diğer errno hatalar da belirtilebilir; bu tür hatalar belirlenimci değildir ve sistem güncelleştirmeleri aracılığıyla aynı davranış korunmayabilir.

Dönüş değeri

Başarı için 0 veya hata için -1 döndürür; bu durumda errno hata değerine ayarlanır.

Uygulama bildirimi gereksinimleri

Uygulama bildirimi WifiConfig özelliğini içermelidir.