Поделиться через

Функция Networking_IpConfig_RenewIp

  • Статья

Заголовок: #include <applibs/networking.h>

Продлевает аренду динамических IP-адресов устройства.

Примечание

Требуется ОС Azure Sphere версии 22.02 или более поздней.

int Networking_IpConfig_RenewIp(const char *networkInterfaceName);

Параметры

  • networkInterfaceName Указатель на имя обновляемого сетевого интерфейса.

Ошибки

Возвращает значение -1 при обнаружении ошибки и задает errno значение ошибки.

  • EACCES: вызывающее приложение не имеет возможности NetworkConfig.

  • EFAULT: networkInterfaceName параметр имеет значение NULL.

  • ENOENT: сетевой интерфейс не существует.

  • EPERM: IP-адрес не может быть обновлен, например в статической IP-конфигурации.

Можно также указать любой другой errno . Такие ошибки не являются детерминированными, и такое же поведение может не сохраняться при обновлении системы.

Возвращаемое значение

Возвращает значение 0 для успешного выполнения, -1 для сбоя, в этом случае errno задается значение ошибки.

Замечания

Если IP-адрес был получен через DHCP, эта функция асинхронно продлевает текущую аренду IP-адреса. Эта функция ничего не делает, если DHCP по-прежнему работает для получения IP-адреса. Если протокол DHCP был остановлен с помощью Networking_IpConfig_ReleaseIp, транзакция DHCP будет запущена повторно. Используйте Networking_IsNetworkingReady , чтобы определить, получен ли новый IP-адрес.

Манифест приложения должен включать возможность NetworkConfig.

Основные понятия и примеры