nl::Inet::InterfaceIterator

مكرّر لقائمة واجهات شبكة النظام.

ملخّص

استخدِم كائنات من هذه الفئة لتكرار قائمة واجهات شبكة النظام.

علمًا بأن الطرق المستخدمة في مثيل فردي من هذه الفئة ليست آمنة لسلاسل المحادثات، ولكن يمكن استخدام مثيلات منفصلة في آنٍ واحد بواسطة سلاسل محادثات متعددة.

في أنظمة LwIP المتعددة السلاسل، تكون المثيلات متوافقة مع سلاسل المحادثات الأخرى التي تصل إلى حالة LwIP العامة بشرط أن تحتفظ سلاسل المحادثات الأخرى بقفل LwIP الأساسي أثناء تبديل قائمة netifs، وأن كائن netif نفسه لا يتم إتلافه أبدًا.

في الأنظمة القائمة على المقابس، يكون التكرار مستقرًا دائمًا في مواجهة التغييرات التي تطرأ على واجهات النظام الأساسي.

في أنظمة LwIP، يكون التكرار ثابتًا إلا إذا تمت إزالة الواجهة المحددة حاليًا من القائمة، وفي هذه الحالة ينتهي التكرار فورًا.

السمات المحمية

size_t mCurIntf

struct netif * mCurNetif

struct if_nameindex * mIntfArray

short mIntfFlags

bool mIntfFlagsCached

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.

bool HasBroadcastAddress(
  void
)

bool HasCurrent(
  void
)

 InterfaceIterator(
  void
)

bool IsUp(
  void
)

bool Next(
  void
)

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

On multi-threaded LwIP systems, this method is thread-safe relative to other
threads accessing the global LwIP state provided that: 1) the other threads
hold the LwIP core lock while mutating the list of netifs; and 2) netif objects
themselves are never destroyed.

Iteration is stable in the face of changes to the underlying system's
interfaces, *except* in the case of LwIP systems when the currently selected
interface is removed from the list, which causes iteration to end immediately.

bool SupportsMulticast(
  void
)

 ~InterfaceIterator(
  void
)

short GetFlags(
  void
)