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

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

ملخّص

Typedefs

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
يستدعي النظام الأساسي هذه الدالة لإنهاء طلب بحث نظام أسماء النطاقات.

Typedefs

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.
  • قد يُلغي نظام OpenCore Core معاملة طلب بحث (ربما انتهت المهلة) من خلال استدعاء otPlatDnsCancelUpstreamQuery، ويجب ألا يستدعي النظام الأساسي otPlatDnsUpstreamQueryDone على معاملة تم إلغاؤها.

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

otPlatDnsUpstreamQueryتم

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

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

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

يمكن للمنصة تمرير nullptr لإغلاق معاملة بدون رد.

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

الموارد

تنشأ مواضيع مراجع OpenThread API من رمز المصدر المتوفّر على GitHub. للحصول على مزيد من المعلومات، أو للمساهمة في مستنداتنا، يُرجى الرجوع إلى المراجع.