Share via

WifiConfig_SetConfigName İşlevi

  • Makale

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

Ağ yapılandırması için bir ad ayarlar. Ad, bir ağ yapılandırmasını tanımlamak için kullanışlı bir tanıtıcı olarak kullanılabilir. Bu adın benzersiz olması kesinlikle önerilir.

Ayar hemen etkindir ancak bu işlevden sonra WifiConfig_PersistConfig işlevi çağrılmadığı sürece cihaz yeniden başlatmalarında kalıcı olmaz.

static int WifiConfig_SetConfigName(int networkId, const char *configName);

Parametre

  • networkId Yapılandırılan ağın kimliği. WifiConfig_AddNetwork ağ kimliğini döndürür.

  • configname Yapılandırma adını içeren bir bayt dizisinin işaretçisi. Bayt dizisi NULL olarak sonlandırılmalıdır ve bayttan küçük veya bayt değerine WIFICONFIG_CONFIG_NAME_MAX_LENGTH eşit 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_CONFIG_NAME_MAX_LENGTHbüyüktür.

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

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

  • EINVAL: networkId parametre geçersiz.

  • ENODEV: networkId parametresi depolanan ağların kimlikleriyle eşleşmiyor.

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.