الخادم

تتضمن هذه الوحدة دوال لإدارة بيانات الشبكة المحلية باستخدام خادم OpenThread.

ملخّص

الدوال
`otServerAddService(otInstance aInstance, const otServiceConfig aConfig)`	`otError` أضِف إعداد خدمة إلى بيانات الشبكة المحلية.
`otServerGetNetDataLocal(otInstance aInstance, bool aStable, uint8_t aData, uint8_t *aDataLength)`	`otError` توفّر نسخة كاملة أو ثابتة من بيانات شبكة Thread المحلية.
`otServerGetNextService(otInstance aInstance, otNetworkDataIterator aIterator, otServiceConfig *aConfig)`	`otError` الحصول على الخدمة التالية في بيانات الشبكة المحلية.
`otServerRegister(otInstance *aInstance)`	`otError` سجِّل بيانات الشبكة المحلية فورًا مع القائد.
`otServerRemoveService(otInstance aInstance, uint32_t aEnterpriseNumber, const uint8_t aServiceData, uint8_t aServiceDataLength)`	`otError` أزِل ضبط الخدمة من بيانات الشبكة المحلية.

الدوال

otServerAddService

otError otServerAddService(
  otInstance *aInstance,
  const otServiceConfig *aConfig
)

أضِف إعداد خدمة إلى بيانات الشبكة المحلية.

التفاصيل

المَعلمات

`[in] aInstance`	يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
`[in] aConfig`	مؤشر لإعداد الخدمة.

قيم الإرجاع

`OT_ERROR_NONE`	تمت إضافة الإعدادات إلى بيانات الشبكة المحلية بنجاح.
`OT_ERROR_INVALID_ARGS`	واحدة أو أكثر من معلمات الإعدادات غير صالحة.
`OT_ERROR_NO_BUFS`	لا تتوفّر مساحة كافية لإضافة الإعدادات إلى بيانات الشبكة المحلية.

راجِع أيضًا:
otServerRemoveService
otServerRegister

otServerGetNetDataLocal

otError otServerGetNetDataLocal(
  otInstance *aInstance,
  bool aStable,
  uint8_t *aData,
  uint8_t *aDataLength
)

توفّر نسخة كاملة أو ثابتة من بيانات شبكة Thread المحلية.

التفاصيل

المَعلمات

`[in] aInstance`	يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
`[in] aStable`	TRUE عند نسخ الإصدار الثابت، وFALSE عند نسخ النسخة الكاملة.
`[out] aData`	يشير هذا المصطلح إلى مؤشر المخزن المؤقت للبيانات.
`[in,out] aDataLength`	عند الإدخال، يشير حجم المخزن المؤقت للبيانات إلى `aData`. عند الخروج، يعرض عدد وحدات البايت المنسوخة.

otServerGetNextService

otError otServerGetNextService(
  otInstance *aInstance,
  otNetworkDataIterator *aIterator,
  otServiceConfig *aConfig
)

الحصول على الخدمة التالية في بيانات الشبكة المحلية.

التفاصيل

المَعلمات

`[in] aInstance`	يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
`[in,out] aIterator`	مؤشر يشير إلى سياق مكرّر بيانات الشبكة. للحصول على إدخال الخدمة الأول، يجب ضبطه على OT_NETWORK_DATA_ITERATOR_INIT.
`[out] aConfig`	مؤشر يشير إلى المكان الذي سيتم وضع معلومات الخدمة فيه.

قيم الإرجاع

`OT_ERROR_NONE`	تم العثور على الخدمة التالية بنجاح.
`OT_ERROR_NOT_FOUND`	لا توجد أي خدمة لاحقة في بيانات شبكة Thread.

otServerRegister

otError otServerRegister(
  otInstance *aInstance
)

سجِّل بيانات الشبكة المحلية فورًا مع القائد.

التفاصيل

المَعلمات

[in] aInstance

يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.

قيم الإرجاع

OT_ERROR_NONE

تم وضع رسالة "طلب بيانات الخادم" في قائمة الانتظار بنجاح للتسليم.

راجِع أيضًا:
otServerAddService
otServerRemoveService

otServerRemoveService

otError otServerRemoveService(
  otInstance *aInstance,
  uint32_t aEnterpriseNumber,
  const uint8_t *aServiceData,
  uint8_t aServiceDataLength
)

أزِل ضبط الخدمة من بيانات الشبكة المحلية.

التفاصيل

المَعلمات

`[in] aInstance`	يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
`[in] aEnterpriseNumber`	رقم المؤسسة لإدخال الخدمة المطلوب حذفه
`[in] aServiceData`	مؤشر يشير إلى "بيانات الخدمة" للبحث عنها أثناء الحذف.
`[in] aServiceDataLength`	طول `aServiceData` بالبايت.

قيم الإرجاع

`OT_ERROR_NONE`	تمت إزالة الإعدادات من بيانات الشبكة المحلية بنجاح.
`OT_ERROR_NOT_FOUND`	تعذّر العثور على إدخال جهاز التوجيه الحدودي.

راجِع أيضًا:
otServerAddService
otServerRegister

المراجِع

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