Google is committed to advancing racial equity for Black communities. See how.

خادم DNS-SD

تتضمن هذه الوحدة واجهات برمجة التطبيقات لخادم 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.

النوع

otDnssdHostInfo typedef
تمثل هذه البنية معلومات عن مضيف تم اكتشافه لاستعلام 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
تمثل هذه البنية معلومات عن مثيل خدمة تم اكتشافه لاستعلام DNS-SD.

المهام

otDnssdGetNextQuery ( otInstance *aInstance, const otDnssdQuery *aQuery)
const otDnssdQuery *
تكتسب هذه الوظيفة الاستعلام التالي في خادم DNS-SD.
otDnssdGetQueryTypeAndName (const otDnssdQuery *aQuery, char(*) aNameOutput[OT_DNS_MAX_NAME_SIZE])
تكتسب هذه الوظيفة نوع استعلام 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.

الهياكل

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

نوع الخدمة حل اسم المضيف.

النوع

otDnssdHostInfo

struct otDnssdHostInfo otDnssdHostInfo

تمثل هذه البنية معلومات عن مضيف تم اكتشافه لاستعلام DNS-SD.

otDnssdQuery

void otDnssdQuery

يمثل هذا النوع المعتم استعلام DNS-SD.

otDnssdQuery الاشتراك

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 .

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

otDnssdQuery إلغاء الاشتراك

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

يتم استدعاء هذه الوظيفة عندما يقوم استعلام DNS-SD بإلغاء الاشتراك في أحد:

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

تنفيذ استعلام DNS-SD هو المسؤول عن تحديد ما aFullName هو.

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

otDnssdServiceInstanceInfo

struct otDnssdServiceInstanceInfo otDnssdServiceInstanceInfo

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

المهام

otDnssdGetNextQuery

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

تكتسب هذه الوظيفة الاستعلام التالي في خادم DNS-SD.

تفاصيل
العوامل
[in] aInstance
بنية مثيل OpenThread.
[in] aQuery
مؤشر الاستعلام. مرر NULL للحصول على الاستعلام الأول.
عائدات
مؤشر إلى الاستعلام أو 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 بايت.
عائدات
نوع استعلام DNS-SD.

otDnssdQueryHandleDiscoveredHost

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

تقوم هذه الوظيفة بإعلام مضيف تم اكتشافه.

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

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

otDnssdQueryHandleDiscoveredServiceInstance

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

تقوم هذه الوظيفة بإعلام مثيل خدمة تم اكتشافه.

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

تفاصيل
العوامل
[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 لإلغاء الاشتراك عندما يتم حل الاستعلام أو مهلة.

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