otSrpClientService
#include <srp_client.h>
يُمثل خدمة عميل SRP.
ملخّص
يجب أن تظل القيم في هذه البنية، بما في ذلك السلاسل المؤقتة للأسماء وإدخالات سجلّ TXT، ثابتة وتظل ثابتة بعد تمرير مثيل من هذه البنية إلى OpenThread من otSrpClientAddService() أو otSrpClientRemoveService().
يتم استخدام/إدارة الحقول mState وmData وmNext من خلال OT Core فقط. ويتم تجاهل قيمتها عند تمرير مثيل otSrpClientService في otSrpClientAddService() أو otSrpClientRemoveService() أو دوال أخرى. لا يحتاج المتصل إلى ضبط هذه الحقول.
يحدّد حقلا mLease وmKeyLease فواصل الإيجار المطلوبة والمفتاح لهذه الخدمة. تشير القيمة "صفر" إلى أنّ الفاصل الزمني غير محدّد، ثم يتم استخدام فواصل إيجار أو مفتاح إيجار تلقائية من otSrpClientGetLeaseInterval() وotSrpClientGetKeyLeaseInterval() لهذه الخدمة. إذا كانت فاصل إيجار المفتاح (سواء تم تحديده بشكل صريح أو محدّد من القيمة التلقائية) أقصر من الفاصل الزمني لإيجار الخدمة، سيعيد عميل SRP استخدام قيمة فاصل الإيجار للفاصل الزمني لإيجار المفتاح أيضًا. على سبيل المثال، إذا تم ضبط mLease بشكل صريح على يومَين وتم ضبط mKeyLease على صفر وضبط القيمة التلقائية لتأجير المفتاح على يوم واحد، يتم أيضًا ضبط مدة إيجار المفتاح المطلوبة لهذه الخدمة على يومَين عند تسجيل هذه الخدمة.
السمات العامة |
|
|---|---|
mData
|
uint32_t
بيانات داخلية (يستخدمها OT Core).
|
mInstanceName
|
const char *
تصنيف اسم مثيل الخدمة (وليس الاسم الكامل).
|
mKeyLease
|
uint32_t
الفاصل الزمني المطلوب لإيجار المفتاح في ثانية - صفر لاستخدامه بشكل تلقائي.
|
mLease
|
uint32_t
الفاصل الزمني المطلوب للإيجار بالثواني - صفر لاستخدام القيمة التلقائية.
|
mName
|
const char *
تصنيفات الخدمة (مثل "_mt._udp"، وليس اسم النطاق بالكامل).
|
mNext
|
struct otSrpClientService *
إشارة إلى الإدخال التالي في قائمة مرتبطة (تتم إدارتها من خلال الوقت الإضافي الأساسي)
|
mNumTxtEntries
|
uint8_t
عدد الإدخالات في مصفوفة
mTxtEntries. |
mPort
|
uint16_t
رقم منفذ الخدمة.
|
mPriority
|
uint16_t
أولوية الخدمة:
|
mState
|
حالة الخدمة (يُديرها فريق OT Core).
|
mSubTypeLabels
|
const char *const *
مصفوفة من تصنيفات النوع الفرعي (يجب أن تنتهي بـ
NULL أو يمكن أن تكون NULL). |
mTxtEntries
|
const otDnsTxtEntry *
مصفوفة من إدخالات TXT (يعرض
mNumTxtEntries عدد الإدخالات). |
mWeight
|
uint16_t
وزن الخدمة.
|
السمات العامة
mData
uint32_t otSrpClientService::mData
بيانات داخلية (يستخدمها OT Core).
mInstanceName
const char * otSrpClientService::mInstanceName
تصنيف اسم مثيل الخدمة (وليس الاسم الكامل).
mKeyLease
uint32_t otSrpClientService::mKeyLease
الفاصل الزمني المطلوب لإيجار المفتاح في ثانية - صفر لاستخدامه بشكل تلقائي.
mLease
uint32_t otSrpClientService::mLease
الفاصل الزمني المطلوب للإيجار بالثواني - صفر لاستخدام القيمة التلقائية.
mName
const char * otSrpClientService::mName
تصنيفات الخدمة (مثل "_mt._udp"، وليس اسم النطاق بالكامل).
mNext
struct otSrpClientService * otSrpClientService::mNext
إشارة إلى الإدخال التالي في قائمة مرتبطة (تتم إدارتها من خلال الوقت الإضافي الأساسي)
mNumTxtEntries
uint8_t otSrpClientService::mNumTxtEntries
عدد الإدخالات في مصفوفة mTxtEntries.
mPort
uint16_t otSrpClientService::mPort
رقم منفذ الخدمة.
mPriority
uint16_t otSrpClientService::mPriority
أولوية الخدمة:
mSubTypeLabels
const char *const * otSrpClientService::mSubTypeLabels
مصفوفة من تصنيفات النوع الفرعي (يجب أن تنتهي بـ NULL أو يمكن أن تكون NULL).
mTxtEntries
const otDnsTxtEntry * otSrpClientService::mTxtEntries
مصفوفة من إدخالات TXT (يعرض mNumTxtEntries عدد الإدخالات).
mWeight
uint16_t otSrpClientService::mWeight
وزن الخدمة.
المراجِع
تنشأ المواضيع المرجعية لواجهة برمجة تطبيقات OpenThread من رمز المصدر المتاح على GitHub. للحصول على مزيد من المعلومات أو للمساهمة في مستنداتنا، يمكنك الاطّلاع على المراجع.