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

Функция Networking_IpConfig_ReleaseIp

  • Статья

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

Освобождает динамический IP-адрес устройства.

Примечание

Требуется ОС Azure Sphere версии 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 задается значение ошибки.

Замечания

Если IP-адрес был получен через DHCP, этот API синхронно отправляет сообщение о выпуске DHCP, но нет никакой гарантии, что оно будет получено. Этот API останавливает попытку протокола DHCP получить IP-адрес до вызова Networking_IpConfig_RenewIp .

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

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