خادم DNS-SD

تتضمن هذه الوحدة واجهات برمجة تطبيقات لخادم نظام أسماء النطاقات-دني.

ملخّص

عمليات التعداد
otDnssdQueryType{   OT_DNSSD_QUERY_TYPE_NONE = 0,   OT_DNSSD_QUERY_TYPE_BROWSE = 1,   OT_DNSSD_QUERY_TYPE_RESOLVE = 2,   OT_DNSSD_QUERY_TYPE_RESOLVE_HOST = 3 }	تعداد تحدِّد هذه السياسة نوع طلب بحث DNS-SD.

تحديدات النوع
otDnssdCounters	typedef struct otDnssdCounters يحتوي على عدّادات خادم DNS-SD.
otDnssdHostInfo	typedef struct otDnssdHostInfo يمثل هذا التمثيل معلومات المضيف المكتشف لطلب بحث DNS-SD.
otDnssdQuery	typedef void ويمثّل هذا النوع الغامض طلب بحث DNS-SD.
otDnssdQuerySubscribeCallback)(void *aContext, const char *aFullName)	typedef void(* يتم استدعاء عندما يشترك استعلام DNS-SD في أحد:
otDnssdQueryUnsubscribeCallback)(void *aContext, const char *aFullName)	typedef void(* يتم استدعاؤه عندما يلغي طلب بحث DNS-SD إلغاء اشتراك أي مما يلي:
otDnssdServiceInstanceInfo	typedef struct otDnssdServiceInstanceInfo يوفّر هذا التمثيل معلومات عن مثيل خدمة مكتشف لطلب بحث DNS-SD.

الدوال
otDnssdGetCounters(otInstance *aInstance)	const otDnssdCounters * تعرض عدّادات خادم DNS-SD.
otDnssdGetNextQuery(otInstance *aInstance, const otDnssdQuery *aQuery)	const otDnssdQuery * للحصول على طلب البحث التالي في خادم DNS-SD.
otDnssdGetQueryTypeAndName(const otDnssdQuery *aQuery, char(*) aNameOutput[OT_DNS_MAX_NAME_SIZE])	otDnssdQueryType للحصول على نوع طلب البحث الذي يخصّ "نظام أسماء النطاقات (DNS-SD) واسمه لطلب بحث محدّد".
otDnssdQueryHandleDiscoveredHost(otInstance *aInstance, const char *aHostFullName, otDnssdHostInfo *aHostInfo)	void لإرسال إشعار إلى مضيف تم اكتشافه
otDnssdQueryHandleDiscoveredServiceInstance(otInstance *aInstance, const char *aServiceFullName, otDnssdServiceInstanceInfo *aInstanceInfo)	void لإرسال إشعار إلى مثيل خدمة تم اكتشافه
otDnssdQuerySetCallbacks(otInstance *aInstance, otDnssdQuerySubscribeCallback aSubscribe, otDnssdQueryUnsubscribeCallback aUnsubscribe, void *aContext)	void لضبط استدعاءات طلب بحث خادم DNS-SD.
otDnssdUpstreamQueryIsEnabled(otInstance *aInstance)	bool تعرض ما إذا كان خادم نظام أسماء النطاقات (DNSSD) سيعيد توجيه طلبات بحث نظام أسماء النطاقات إلى واجهة برمجة التطبيقات الخاصة بالنظام الأساسي لنظام أسماء النطاقات.
otDnssdUpstreamQuerySetEnabled(otInstance *aInstance, bool aEnabled)	void يمكنك تفعيل أو إيقاف إعادة توجيه طلبات بحث نظام أسماء النطاقات إلى واجهة برمجة تطبيقات نظام أسماء النطاقات الرئيسية.

الهياكل
otDnssdCounters	يحتوي على عدّادات خادم DNS-SD.
otDnssdHostInfo	يمثل هذا التمثيل معلومات المضيف المكتشف لطلب بحث DNS-SD.
otDnssdServiceInstanceInfo	يوفّر هذا التمثيل معلومات عن مثيل خدمة مكتشف لطلب بحث DNS-SD.

عمليات التعداد

otDnssdQueryType

 otDnssdQueryType

تحدِّد هذه السياسة نوع طلب بحث DNS-SD.

أماكن إقامة
OT_DNSSD_QUERY_TYPE_BROWSE	خدمة تصفح نوع الخدمة.
OT_DNSSD_QUERY_TYPE_NONE	نوع الخدمة غير محدد.
OT_DNSSD_QUERY_TYPE_RESOLVE	نوع الخدمة يحل مثيل الخدمة
OT_DNSSD_QUERY_TYPE_RESOLVE_HOST	اسم المضيف لحل نوع الخدمة.

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

otDnssdCounters

struct otDnssdCounters otDnssdCounters

يحتوي على عدّادات خادم DNS-SD.

otDnssdHostInfo

struct otDnssdHostInfo otDnssdHostInfo

يمثل هذا التمثيل معلومات المضيف المكتشف لطلب بحث DNS-SD.

otDnssdQuery

void otDnssdQuery

ويمثّل هذا النوع الغامض طلب بحث DNS-SD.

otDnssdQuerySubscribeCallback

void(* otDnssdQuerySubscribeCallback)(void *aContext, const char *aFullName)

يتم استدعاء عندما يشترك استعلام DNS-SD في أحد:

1. اسم خدمة.
2. باسم مثيل الخدمة.
3. اسم مضيف.

يكون تنفيذ طلب بحث DNS-SD مسؤولًا عن تحديد معنى aFullName. إذا كان aFullName هو اسم خدمة أو اسم مثيل خدمة، من المفترض أن يكتشف تنفيذ طلب بحث DNS-SD معلومات عن مثيل الخدمة ويرسل إشعارًا إلى خادم DNS-SD باستخدام otDnssdQueryHandleDiscoveredServiceInstance. إذا كان aFullName اسم مضيف، يجب أن يكتشف تنفيذ طلب بحث DNS-SD معلومات المضيف وإشعار خادم DNS-SD باستخدام otDnssdQueryHandleDiscoveredHost.

ملاحظة: يمكن أن تتوفر عدة اشتراكات بالاسم نفسه. يجب أن يسجِّل تنفيذ طلب بحث نظام أسماء النطاقات-SD عدد الاشتراكات النشطة والتوقف عن إرسال إشعار في حال عدم توفر اشتراك نشط لـ aFullName.

التفاصيل
المَعلمات	[in] aContext مؤشر إلى السياق الخاص بالتطبيق. [in] aFullName اسم الخدمة الكامل الذي تم إنهاؤه بدون قيمة (مثل " _ipps._tcp.default.service.arpa"). أو اسم مثيل الخدمة الكامل (مثل "OpenThread._ipps._tcp.default.service.arpa.")، أو اسم المضيف بالكامل (مثل "ot-host.default.service.arpa.").

راجِع أيضًا:
otDnssdQueryHandleDiscoveredServiceInstance
otDnssdQueryHandleDiscoveredHost

otDnssdQueryUnsubscribeCallback

void(* otDnssdQueryUnsubscribeCallback)(void *aContext, const char *aFullName)

يتم استدعاؤه عندما يلغي طلب بحث DNS-SD إلغاء اشتراك أي مما يلي:

1. اسم خدمة.
2. باسم مثيل الخدمة.
3. اسم مضيف.

يُعد تنفيذ طلب بحث DNS-SD مسؤولًا عن تحديد aFullName.

ملاحظة: يمكن أن تتوفر عدة اشتراكات بالاسم نفسه. يجب أن يسجِّل تنفيذ طلب بحث نظام أسماء النطاقات-SD عدد الاشتراكات النشطة والتوقف عن إرسال إشعار في حال عدم توفر اشتراك نشط لـ aFullName.

التفاصيل
المَعلمات	[in] aContext مؤشر إلى السياق الخاص بالتطبيق. [in] aFullName اسم الخدمة الكامل الذي تم إنهاؤه بدون قيمة (مثل " _ipps._tcp.default.service.arpa.")، أو اسم مثيل الخدمة الكامل (مثل OpenThread._ipps._tcp.default.service.arpa).

otDnssdServiceInstanceInfo

struct otDnssdServiceInstanceInfo otDnssdServiceInstanceInfo

يوفّر هذا التمثيل معلومات عن مثيل خدمة مكتشف لطلب بحث DNS-SD.

الدوال

otDnssdGetCounters

const otDnssdCounters * otDnssdGetCounters(
  otInstance *aInstance
)

تعرض عدّادات خادم DNS-SD.

التفاصيل
المَعلمات	[in] aInstance بنية النسخة الافتراضية OpenThread
المرتجعات	مؤشر يشير إلى عدّادات خادم DNS-SD.

otDnssdGetNextQuery

const otDnssdQuery * otDnssdGetNextQuery(
  otInstance *aInstance,
  const otDnssdQuery *aQuery
)

للحصول على طلب البحث التالي في خادم DNS-SD.

التفاصيل
المَعلمات	[in] aInstance بنية النسخة الافتراضية OpenThread [in] aQuery مؤشر طلب البحث مرر "NULL" (فارغ) للحصول على الاستعلام الأول.
المرتجعات	مؤشر إلى الاستعلام أو فارغ في حال عدم وجود المزيد من الاستعلامات.

otDnssdGetQueryTypeAndName

otDnssdQueryType otDnssdGetQueryTypeAndName(
  const otDnssdQuery *aQuery,
  char(*) aNameOutput[OT_DNS_MAX_NAME_SIZE]
)

للحصول على نوع طلب البحث الذي يخصّ "نظام أسماء النطاقات (DNS-SD) واسمه لطلب بحث محدّد".

التفاصيل
المَعلمات	[in] aQuery مؤشر طلب البحث الذي تم الحصول عليه من otDnssdGetNextQuery. [out] aNameOutput اسم المخزن المؤقت للمخرجات، والذي يجب أن يبلغ طوله OT_DNS_MAX_NAME_SIZE بايت.
المرتجعات	نوع طلب البحث لنظام أسماء النطاقات-SD.

otDnssdQueryHandleDiscoveredHost

void otDnssdQueryHandleDiscoveredHost(
  otInstance *aInstance,
  const char *aHostFullName,
  otDnssdHostInfo *aHostInfo
)

لإرسال إشعار إلى مضيف تم اكتشافه

يجب أن يستدعي برنامج تعيين طلبات البحث الخارجي (على سبيل المثال، الخادم الوكيل للاستكشاف) هذه الدالة لإرسال إشعار إلى مجموعة OpenThread الأساسية للمضيفين المشتركين.

ملاحظة: يجب ألا يحتوي aHostInfo على عناوين IP غير محدّدة أو مرتبطة برابط محلي أو عناوين IP متكررة أو ذات بث متعدّد.

التفاصيل
المَعلمات	[in] aInstance بنية النسخة الافتراضية OpenThread [in] aHostFullName اسم المضيف الكامل الذي تم إنهاؤه فارغًا. [in] aHostInfo يشير إلى المعلومات التي تم اكتشافها عن الخدمة الافتراضية.

otDnssdQueryHandleDiscoveredServiceInstance

void otDnssdQueryHandleDiscoveredServiceInstance(
  otInstance *aInstance,
  const char *aServiceFullName,
  otDnssdServiceInstanceInfo *aInstanceInfo
)

لإرسال إشعار إلى مثيل خدمة تم اكتشافه

يجب أن يستدعي برنامج تعيين طلبات البحث الخارجي (مثل الخادم الوكيل للاستكشاف) هذه الدالة لإرسال إشعار إلى مجموعة OpenThread الأساسية للخدمات أو مثيلات الخدمة التي تم الاشتراك فيها.

ملاحظة: يجب ألا يحتوي aInstanceInfo على عناوين IP غير محدّدة أو مرتبطة برابط محلي أو عناوين IP متكررة أو ذات بث متعدّد.

التفاصيل
المَعلمات	[in] aInstance بنية النسخة الافتراضية OpenThread [in] aServiceFullName اسم الخدمة الكامل الذي تم إنهاؤه فارغًا. [in] aInstanceInfo يشير إلى المعلومات التي تم اكتشافها عن الخدمة الافتراضية.

otDnssdQuerySetCallbacks

void otDnssdQuerySetCallbacks(
  otInstance *aInstance,
  otDnssdQuerySubscribeCallback aSubscribe,
  otDnssdQueryUnsubscribeCallback aUnsubscribe,
  void *aContext
)

لضبط استدعاءات طلب بحث خادم DNS-SD.

يستدعي خادم DNS-SD aSubscribe للاشتراك في خدمة أو مثيل خدمة لحل طلب بحث DNS-SD وaUnsubscribe لإلغاء الاشتراك عند حل الطلب أو انتهاء صلاحيته.

ملاحظة:يجب ضبط كل من aSubscribe وaUnsubscribe أو تركهما بدون ضبط.

التفاصيل
المَعلمات	[in] aInstance بنية النسخة الافتراضية OpenThread [in] aSubscribe مؤشر يشير إلى دالة رد الاتصال للاشتراك في خدمة أو مثيل خدمة. [in] aUnsubscribe مؤشر لدالة معاودة الاتصال لإلغاء اشتراك خدمة أو مثيل خدمة. [in] aContext مؤشر إلى السياق الخاص بالتطبيق.

otDnssdUpstreamQueryIsEnabled

bool otDnssdUpstreamQueryIsEnabled(
  otInstance *aInstance
)

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

تتوفّر هذه الميزة عندما تكون ميزة "OPENTHREAD_CONFIG_DNS_UPSTREAM_QUERY_ENABLE" مفعّلة.

التفاصيل
المَعلمات	[in] aInstance يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
قيم الإرجاع	TRUE في حال كان خادم DNSSD يعيد توجيه طلبات نظام أسماء النطاقات. FALSE في حال لم يعيد خادم DNSSD توجيه طلبات بحث نظام أسماء النطاقات.

راجِع أيضًا:
otDnssdUpstreamQuerySetEnabled

otDnssdUpstreamQuerySetEnabled

void otDnssdUpstreamQuerySetEnabled(
  otInstance *aInstance,
  bool aEnabled
)

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

تتوفّر هذه الميزة عندما تكون ميزة "OPENTHREAD_CONFIG_DNS_UPSTREAM_QUERY_ENABLE" مفعّلة.

التفاصيل
المَعلمات	[in] aInstance يشير هذا المصطلح إلى مؤشر لمثيل OpenThread. [in] aEnabled قيمة منطقية لتفعيل/إيقاف إعادة توجيه طلبات بحث نظام أسماء النطاقات إلى المصدر

راجِع أيضًا:
otPlatDnsStartUpstreamQuery
otPlatDnsCancelUpstreamQuery
otPlatDnsUpstreamQueryDone

المراجِع

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