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

Функция Networking_GetInterfaces

  • Статья

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

Возвращает список сетевых интерфейсов на устройстве Azure Sphere. Если outNetworkInterfaces значение слишком мало для хранения всех сетевых интерфейсов в системе, эта функция заполняет массив и возвращает количество элементов массива. Количество интерфейсов в системе не изменится в течение цикла загрузки.

ssize_t Networking_GetInterfaces(Networking_NetworkInterface *outNetworkInterfacesArray, size_t networkInterfacesArrayCount);

Параметры

  • outNetworkInterfacesArray Указатель на массив Networking_NetworkInterface структур для заполнения свойствами сетевого интерфейса. Вызывающий объект должен выделить память для массива после вызова Networking_GetInterfacesCount , чтобы получить количество интерфейсов на устройстве.

  • networkInterfacesArrayCount Количество элементов outNetworkInterfacesArray , которые могут храниться. Массив должен содержать по одному элементу для каждого сетевого интерфейса на устройстве.

Ошибки

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

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

  • ERANGE: networkInterfacesArrayCount пармейтер равен 0.

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

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

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

Возвращает количество сетевых интерфейсов, добавленных в outNetworkInterfaces массив. В противном случае —1 для сбоя, в этом случае errno задается значение ошибки.

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