nl::Inet::AsyncDNSResolverSockets

#include <src/inet/AsyncDNSResolverSockets.h>

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

ملخّص

لا توجد واجهة عامة متاحة لطبقة التطبيق.

وظائف عامة
Cancel(DNSResolver & resolver)
إلغاء طلب بحث نظام أسماء نطاقات معلق قد لا يزال نشطًا.
EnqueueRequest(DNSResolver & resolver)
أدخِل كائن DNSResolver في قائمة الدقة غير المتزامنة لعنوان IP لاسم المضيف المحدَّد.
Init(InetLayer *inet)
المُهيئ الصريح لفئة AsynchronousDNSAnswerrSockets.
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
)

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

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

EnqueueRequest

INET_ERROR EnqueueRequest(
  DNSResolver & resolver
)

أدخِل كائن DNSResolver في قائمة الدقة غير المتزامنة لعنوان IP لاسم المضيف المحدَّد.

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

Init

INET_ERROR Init(
  InetLayer *inet
)

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

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

التفاصيل
المعلمات
[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
في حالة معالجة طلب DNS بنجاح.

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

INET_ERROR Shutdown(
  void
)

هذا هو مزيل التكوين الصريح للفئة AsyncDNSResolverSockets، ويهتم بإيقاف سلاسل المحادثات وإتلاف متغيري الاستبعاد والنسيج.

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