nl::Inet::AsyncDNSResolverSockets

#include <src/inet/AsyncDNSResolverSockets.h>

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

ملخّص

لا تتوفر أي واجهة عامة لطبقة التطبيق.

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

الدوال العامة

إلغاء

INET_ERROR Cancel(
  DNSResolver & resolver
)

إلغاء طلب بحث DNS مُعلَّق الذي ربما لا يزال نشطًا

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

EnqueueRequest

INET_ERROR EnqueueRequest(
  DNSResolver & resolver
)

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

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

إنت

INET_ERROR Init(
  InetLayer *inet
)

المهيئ الصريح لفئة AsynchronousDNSknowrSockets.

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

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

PrepareDNSResolver

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

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

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

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

INET_ERROR Shutdown(
  void
)

هذا هو أداة إلغاء الضبط الصريحة لفئة AsyncDNSResolverSockets، وهي تهتم بإغلاق سلاسل المحادثات وإتلاف متغيّرات المزامنة والتسلسل.

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