nl::Inet::InterfaceAddressIterator

איטרטור לרשימת כתובות ה-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
)