nl::Inet::AsyncDNSSolverSockets

#include <src/inet/AsyncDNSResolverSockets.h>

هذه فئة داخلية إلى InetLayer توفر واجهات برمجة تطبيقات مساعدة لحل نظام أسماء النطاقات غير المتزامن (DNS) في InetLayer.

الملخّص

ليس هناك واجهة عامة متاحة لطبقة التطبيق.

وظائف عامة
Cancel(DNSResolver & resolver)
إلغاء طلب بحث نظام أسماء النطاقات المستحق الذي قد يكون نشطًا.
EnqueueRequest(DNSResolver & resolver)
إدراج كائن DNSSolver في قائمة انتظار تحليل عنوان IP غير المتزامن لاسم مضيف محدد.
Init(InetLayer *inet)
المُنشئ الصريح لصف AsynchronousDNSSolverSockets
PrepareDNSResolver(DNSResolver & resolver, const char *hostName, uint16_t hostNameLen, uint8_t options, uint8_t maxAddrs, IPAddress *addrArray, DNSResolver::OnResolveCompleteFunct onComplete, void *appState)
تعمل هذه الطريقة على إعداد كائن نظام أسماء النطاقات قبل الحل غير المتزامن.
Shutdown(void)
هذه هي أداة تمهيدية صريحة لفئة AsyncDNSSolverSockets وستتولى مسؤولية إغلاق سلاسل المحادثات وإتلاف متغيرات Mux وSEmorhore.

وظائف عامة

إلغاء

INET_ERROR Cancel(
  DNSResolver & resolver
)

إلغاء طلب بحث نظام أسماء النطاقات المستحق الذي قد يكون نشطًا.

التفاصيل
المعلَمات
[in] resolver
مرجع إلى الكائن DNSSolver.

طلب قائمة الانتظار

INET_ERROR EnqueueRequest(
  DNSResolver & resolver
)

إدراج كائن DNSSolver في قائمة انتظار تحليل عنوان IP غير المتزامن لاسم مضيف محدد.

التفاصيل
المعلَمات
[in] resolver
مرجع إلى الكائن DNSSolver.
قيم الإرجاع
INET_NO_ERROR
إذا تم وضع طلب نظام أسماء النطاقات في قائمة الانتظار بنجاح.
INET_ERROR_NO_MEMORY
إذا كانت مجموعة أداة تعيين طبقة Inet ممتلئة
other
حدث خطأ في شبكة POSIX أو نظام التشغيل.

إنيت

INET_ERROR Init(
  InetLayer *inet
)

المُنشئ الصريح لصف AsynchronousDNSSolverSockets

يؤدي ذلك إلى إعداد متغيرات Mux وSEmehore وإنشاء سلاسل المحادثات لمعالجة درجة دقة نظام أسماء النطاقات غير المتزامن.

التفاصيل
المعلَمات
[in] aInet
مؤشر إلى العنصر InetLayer.
قيم الإرجاع
INET_NO_ERROR
في حالة إتمام الإعداد بنجاح.
other
حدث خطأ في شبكة POSIX أو نظام التشغيل.

تطبيق محلل نظام أسماء النطاقات

INET_ERROR PrepareDNSResolver(
  DNSResolver & resolver,
  const char *hostName,
  uint16_t hostNameLen,
  uint8_t options,
  uint8_t maxAddrs,
  IPAddress *addrArray,
  DNSResolver::OnResolveCompleteFunct onComplete,
  void *appState
)

تعمل هذه الطريقة على إعداد كائن نظام أسماء النطاقات قبل الحل غير المتزامن.

التفاصيل
المعلَمات
[in] resolver
مرجع إلى عنصر DNSSolver مخصّص.
[in] hostName
مؤشر إلى سلسلة C تمثل اسم المضيف الذي سيتم طلبه.
[in] hostNameLen
طول سلسلة اسم المضيف.
[in] options
قيمة عدد صحيح تتحكم في كيفية تنفيذ دقة عنوان اسم المضيف. تأتي القيم من تعداد #DNSOptions.
[in] maxAddrs
الحد الأقصى لعدد العناوين المطلوب تخزينها في جدول نظام أسماء النطاقات.
[in] addrArray
مؤشر إلى جدول نظام أسماء النطاقات.
[in] onComplete
مؤشر إلى دالة رد الاتصال عند اكتمال طلب نظام أسماء النطاقات.
[in] appState
مؤشر إلى حالة التطبيق ليتم تمريره إلى onComplete عند اكتمال طلب نظام أسماء النطاقات.
قيم الإرجاع
INET_NO_ERROR
إذا تم التعامل مع طلب نظام أسماء النطاقات بنجاح.

إيقاف التشغيل

INET_ERROR Shutdown(
  void
)

هذه هي أداة تمهيدية صريحة لفئة AsyncDNSSolverSockets وستتولى مسؤولية إغلاق سلاسل المحادثات وإتلاف متغيرات Mux وSEmorhore.

التفاصيل
قيم الإرجاع
INET_NO_ERROR
في حال نجاح عملية إيقاف التشغيل.
other
حدث خطأ في شبكة POSIX أو نظام التشغيل.