Share via


Networking_IpConfig_ReleaseIp İşlevi

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

Cihaz dinamik IP adresini serbest bırakır.

Not

Azure Sphere işletim sistemi sürüm 22.02 veya üzerini gerektirir.

int Networking_IpConfig_ReleaseIp(const char *networkInterfaceName);

Parametre

  • networkInterfaceName Güncelleştirilecek ağ arabiriminin adına ilişkin bir işaretçi.

Hata

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

  • EACCES: Çağıran uygulamanın NetworkConfig özelliği yoktur.

  • EFAULT: networkInterfaceName parametresi NULL'dir.

  • ENOENT: Ağ arabirimi yok.

  • EPERM: STATIK IP yapılandırmasında olduğu gibi IP adresi serbest bırakılamaz.

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, hata için -1 döndürür; bu durumda errno hata değerine ayarlanır.

Açıklamalar

DHCP aracılığıyla bir IP alındıysa, bu API zaman uyumlu olarak DHCP yayın iletisini gönderir, ancak alındığının garantisi yoktur. Bu API, Networking_IpConfig_RenewIp çağrılana kadar DHCP protokollerinin IP adresi almayı denemesini durdurur.

Uygulama bildirimi NetworkConfig özelliğini içermelidir.

Kavramlar ve örnekler