Share via

WifiConfig_StoreWpa2Network İşlevi

  • Makale

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

Önemli

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

Önceden paylaşılan anahtar kullanan bir WPA2 Wi-Fi ağı depolar. Bu işlev iş parçacığı güvenli değil.

Not

Aynı SSID ve önceden paylaşılan anahtara sahip bir ağ zaten depolanmışsa bu işlev başarısız olur. Hata bölümüne (EEXIST) bakın.

int WifiConfig_StoreWpa2Network(const uint8_t * ssid, size_t ssidLength, const char * psk, size_t pskLength);

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ı.

  • psk Wi-Fi ağı için önceden paylaşılan anahtarı içeren bir arabelleğe yönelik işaretçi.

  • pskLength Wi-Fi ağı için önceden paylaşılan anahtarın uzunluğu.

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 ve WPA2 kullanan bir depolanmış Wi-Fi ağı zaten var.

  • EFAULT: ssid veya psk NULL değeridir.

  • ERANGE: veya parametresi ve değerinden ssidLength 0 veya büyüktür WIFICONFIG_SSID_MAX_LENGTHWIFICONFIG_WPA2_KEY_MAX_BUFFER_SIZE.pskLength

  • 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.