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


Функция Networking_IpConfig_Apply

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

Применяет IP-конфигурацию к сетевому интерфейсу.

int Networking_IpConfig_Apply(const char *networkInterfaceName, const Networking_IpConfig *ipConfig);

Параметры

  • networkInterfaceName Имя настраиваемого сетевого интерфейса.

  • ipConfig Указатель на структуру Networking_IpConfig , содержащую ip-конфигурацию для применения.

Ошибки

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

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

  • ENOENT: networkInterfaceName параметр ссылается на интерфейс, который не существует.

  • EPERM: эта операция запрещена в сетевом интерфейсе.

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

  • EAGAIN: сетевой стек еще не готов.

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

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

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

Замечания

Эта функция не проверяет, совместим ли статический IP-адрес с динамическими IP-адресами, полученными через интерфейс с помощью DHCP-клиента.

Эта функция не проверяет, доступен ли DHCP-сервер в сети и настроен ли динамический IP-адрес.

Если на устройстве присутствуют перекрывающиеся конфигурации IP-адресов, поведение этой функции не определено.

Требования к манифесту приложения

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

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