нл:: Инет:: ИтераторАдресИнтерфейса

Итератор для списка IP-адресов сетевых интерфейсов системы.

Краткое содержание

Используйте объекты этого класса для перебора списка IP-адресов системного сетевого интерфейса.

Методы отдельного экземпляра этого класса не являются потокобезопасными; однако отдельные экземпляры могут использоваться одновременно несколькими потоками.

В многопоточных системах LwIP экземпляры являются потокобезопасными относительно других потоков, обращающихся к глобальному состоянию LwIP, при условии, что: 1) другие потоки удерживают блокировку ядра LwIP при изменении списка нетифов; и 2) сами объекты netif никогда не уничтожаются.

В системах на основе сокетов итерация всегда стабильна при изменении интерфейсов и/или адресов базовой системы.

В системах LwIP итерация стабильна, за исключением случая, когда интерфейс, связанный с текущим адресом, удаляется, и в этом случае итерация может завершиться преждевременно.

Общественные функции

IPAddress GetAddress(
  void
)

void GetAddressWithPrefix(
  IPPrefix & addrWithPrefix
)

uint8_t GetIPv6PrefixLength(
  void
)

InterfaceId GetInterface(
  void
)

InterfaceId GetInterfaceId(
  void
)

INET_ERROR GetInterfaceName(
  char *nameBuf,
  size_t nameBufSize
)

Writes the name of the network interface as \c NUL terminated text string
at \c nameBuf.

uint8_t GetPrefixLength(
  void
)

On LwIP, this method simply returns the hard-coded constant 64.

Note Well: the standard subnet prefix on all links other than PPP
links is 64 bits. On PPP links and some non-broadcast multipoint access
links, the convention is either 127 bits or 128 bits, but it might be
something else. On most platforms, the system's interface address
structure can represent arbitrary prefix lengths between 0 and 128.

bool HasBroadcastAddress(
  void
)

bool HasCurrent(
  void
)

 InterfaceAddressIterator(
  void
)

bool IsUp(
  void
)

bool Next(
  void
)

Advances the iterator to the next interface address or to a position
beyond the end of the address list.

On LwIP, this method is thread-safe provided that: 1) other threads hold
the LwIP core lock while mutating the netif list; and 2) netif objects
themselves are never destroyed.  Additionally, iteration on LwIP systems
will terminate early if the current interface is removed from the list.

bool SupportsMulticast(
  void
)

 ~InterfaceAddressIterator(
  void
)