Share via


Networking_IpConfig_ReleaseIp関数

ヘッダー: applibs </networking.h #include>

デバイスの動的 IP アドレスを解放します。

メモ

Azure Sphere OS バージョン 22.02 以降が必要です。

int Networking_IpConfig_ReleaseIp(const char *networkInterfaceName);

パラメーター

  • networkInterfaceName 更新するネットワーク インターフェイスの名前へのポインター。

エラー

エラーが発生した場合は -1 を返し、エラー値に設定します errno

  • EACCES: 呼び出し元のアプリケーションに NetworkConfig 機能がありません。

  • EFAULT: パラメーターは networkInterfaceName NULL です。

  • ENOENT: ネットワーク インターフェイスが存在しません。

  • EPERM: 静的 IP 構成など、IP アドレスを解放できません。

その他 errno のエラーも指定できます。このようなエラーは決定的ではなく、同じ動作はシステム更新によって保持されない可能性があります。

戻り値

成功の場合は 0、失敗の場合は -1 を返します。この場合 errno はエラー値に設定されます。

発言

DHCP 経由で IP が取得された場合、この API は DHCP リリース メッセージを同期的に送信しますが、受信される保証はありません。 この API は、NETWORKING_IPCONFIG_RENEWIPが呼び出されるまで DHCP プロトコルが IP アドレスの取得を試みるの 停止します。

アプリケーション マニフェストには、NetworkConfig 機能が含まれている必要があります。

概念とサンプル