Share via

WifiConfig_GetNetworkIdByConfigName İşlevi

  • Makale

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

Verilen ada sahip ağ yapılandırmasının ağ kimliğini alır. Ağ adını atamak için WifiConfig_SetConfigName kullanın. Ağ yapılandırmaları eklendikçe ve kaldırıldığında ağ kimliği değişebilir, bu nedenle uygulamaların depolanan ağ yapılandırmasını değiştirmeden önce ağ kimliğini yeniden alması gerekir.

int WifiConfig_GetNetworkIdByConfigName(const char *configName);

Parametre

  • configName Ağ yapılandırmasının adına ilişkin bir işaretçi. Bu ad WifiConfig_SetConfigName kullanılarak ayarlandı. Dize NULL olarak sonlandırılmalıdır ve bayttan küçük veya buna eşit WIFICONFIG_CONFIG_NAME_MAX_LENGTH olmalıdır (sonlandırma hariç).

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.

  • EFAULT: configName parametresi NULL'dir.

  • ERANGE: parametresi değerinden configNameWIFICONFIG_SSID_MAX_LENGTHbüyüktür.

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

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

  • ENODEV: Belirtilen ağ yapılandırması bulunamıyor.

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

Belirtilen ağın ağ kimliğini (negatif olmayan değer) veya hata için -1 değerini döndürür; bu durumda errno hata değerine ayarlanır. Ağ kimliği, yapılandırılacak ağın tanımlayıcısı olarak WifiConfig_Setxxx işlevlerine geçirilir.

Uygulama bildirimi gereksinimleri

Uygulama bildirimi WifiConfig özelliğini içermelidir.