WifiConfig_GetNetworkIdByConfigName İşlevi
Ü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şitWIFICONFIG_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
configName
WIFICONFIG_SSID_MAX_LENGTH
bü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.