ترجمت واجهة Cloud Translation API‏ هذه الصفحة.

الخادم

تتضمن هذه الوحدة وظائف لإدارة بيانات الشبكة المحلية باستخدام OpenOpen Server.

الملخّص

الدوال
`otServerAddService(otInstance aInstance, const otServiceConfig aConfig)`	`otError` أضِف إعداد خدمة إلى بيانات الشبكة المحلية.
`otServerGetNetDataLocal(otInstance aInstance, bool aStable, uint8_t aData, uint8_t *aDataLength)`	`otError` توفِّر هذه الطريقة نسخة كاملة أو ثابتة من بيانات شبكة سلاسل المحادثات المحلية.
`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
)

توفِّر هذه الطريقة نسخة كاملة أو ثابتة من بيانات شبكة سلاسل المحادثات المحلية.

التفاصيل

المعلَمات

`[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`	لا تتوفّر خدمة لاحقة في بيانات شبكة سلاسل المحادثات.

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. للاطّلاع على مزيد من المعلومات أو للمساهمة في مستنداتنا، يُرجى الرجوع إلى المراجع.