DNS - النظام الأساسي

تتضمن هذه الوحدة تجريد النظام الأساسي لإرسال استعلام نظام أسماء النطاقات التكراري إلى خوادم نظام أسماء النطاقات الرئيسية.

ملخّص

تحديدات النوع
otPlatDnsUpstreamQuery typedef
يمثّل هذا النوع المبهم معاملة طلب بحث لنظام أسماء النطاقات الرئيسي.

الدوال
otPlatDnsCancelUpstreamQuery(otInstance *aInstance, otPlatDnsUpstreamQuery *aTxn)
void
لإلغاء معاملة طلب بحث رئيسي.
otPlatDnsStartUpstreamQuery(otInstance *aInstance, otPlatDnsUpstreamQuery *aTxn, const otMessage *aQuery)
void
لبدء معاملة طلب بحث رئيسي.
otPlatDnsUpstreamQueryDone(otInstance *aInstance, otPlatDnsUpstreamQuery *aTxn, otMessage *aResponse)
void
يستدعي النظام الأساسي هذه الدالة لإنهاء استعلام نظام أسماء النطاقات.

تحديدات النوع

otPlatDnsUpstreamQuery

struct otPlatDnsUpstreamQuery otPlatDnsUpstreamQuery

يمثّل هذا النوع المبهم معاملة طلب بحث لنظام أسماء النطاقات الرئيسي.

الدوال

otPlatDnsCancelUpstreamQuery

void otPlatDnsCancelUpstreamQuery(
  otInstance *aInstance,
  otPlatDnsUpstreamQuery *aTxn
)

لإلغاء معاملة طلب بحث رئيسي.

يجب أن تطلب المنصة من otPlatDnsUpstreamQueryDone إصدار الموارد.

التفاصيل
المَعلمات
[in] aInstance
بنية النسخة الافتراضية OpenThread
[in] aTxn
مؤشر يشير إلى كائن معاملة طلب بحث نظام أسماء النطاقات المبهم.

otPlatDnsStartUpstreamQuery

void otPlatDnsStartUpstreamQuery(
  otInstance *aInstance,
  otPlatDnsUpstreamQuery *aTxn,
  const otMessage *aQuery
)

لبدء معاملة طلب بحث رئيسي.

  • في حالة النجاح (والأخطاء التي تمثلها رسائل بروتوكول نظام أسماء النطاقات)، من المتوقع أن يطلب النظام الأساسي otPlatDnsUpstreamQueryDone.
  • قد يلغي النظام الأساسي OpenThread معاملة طلب بحث (ربما انتهت المهلة) عن طريق استدعاء otPlatDnsCancelUpstreamQuery، ويجب ألا يستدعي النظام الأساسي otPlatDnsUpstreamQueryDone على معاملة ملغاة.

التفاصيل
المَعلمات
[in] aInstance
بنية النسخة الافتراضية OpenThread
[in] aTxn
مؤشر يشير إلى كائن معاملة طلب بحث نظام أسماء النطاقات المبهم.
[in] aQuery
يشير هذا المصطلح إلى مخزن مؤقّت للرسائل من حمولة نظام أسماء النطاقات يجب إرساله إلى خادم نظام أسماء النطاقات الرئيسي.

otPlatDnsUpstreamQueryDone

void otPlatDnsUpstreamQueryDone(
  otInstance *aInstance,
  otPlatDnsUpstreamQuery *aTxn,
  otMessage *aResponse
)

يستدعي النظام الأساسي هذه الدالة لإنهاء استعلام نظام أسماء النطاقات.

سيتم إصدار المعاملة، بحيث لا يمكن للمنصة الأساسية إجراء المعاملة نفسها مرتين. تنقل هذه الدالة ملكية aResponse إلى حزمة OpenThread.

يمكن للنظام الأساسي تمرير قيمة nullptr لإغلاق المعاملة بدون استجابة.

التفاصيل
المَعلمات
[in] aInstance
بنية النسخة الافتراضية OpenThread
[in] aTxn
مؤشر يشير إلى كائن معاملة طلب بحث نظام أسماء النطاقات المبهم.
[in] aResponse
يشير هذا المصطلح إلى مخزن مؤقت للرسائل الخاص بحمولة الاستجابة لنظام أسماء النطاقات أو nullptr لإغلاق معاملة بدون ردّ.

المراجِع

تنشأ المواضيع المرجعية لواجهة برمجة تطبيقات OpenThread من رمز المصدر المتاح على GitHub. للحصول على مزيد من المعلومات أو للمساهمة في مستنداتنا، يمكنك الاطّلاع على المراجع.