otDnsTxtEntry
#include <dns.h>
يمثل إدخال سجل TXT الذي يمثل زوج مفتاح/قيمة (RFC 6763 - القسم 6.3).
ملخّص
يجب أن تظل سلاسل التخزين المؤقتة المُشار إليها من خلال mKey وmValue كما هي بدون تغيير بعد تمرير مثيل من هذه البنية إلى OpenThread (كجزء من مثيل otSrpClientService).
يتم استخدام مصفوفة من إدخالات otDnsTxtEntry في otSrpClientService لتحديد سجلّ TXT الكامل (قائمة بالإدخالات).
السمات العامة |
|
|---|---|
mKey
|
const char *
سلسلة مفتاح سجلّ TXT
|
mValue
|
const uint8_t *
قيمة سجلّ TXT أو تم ترميز TXT-DATA من قبل (بناءً على
mKey). |
mValueLength
|
uint16_t
عدد وحدات البايت في المخزن المؤقت
mValue. |
السمات العامة
mKey
const char * otDnsTxtEntry::mKey
سلسلة مفتاح سجلّ TXT
إذا لم تكن القيمة mKey فارغة، يجب أن تكون سلسلة C ذات قيمة فارغة. يتم التعامل مع الإدخال كزوج مفتاح/قيمة مع المخزن المؤقت mValue الذي يقدّم القيمة.
- تم ترميز الإدخال على النحو التالي:
- يشير ذلك المصطلح إلى بايت واحد بطول السلسلة متبوع بتنسيق "key=value" (بدون علامات اقتباس).
- في هذه الحالة، يجب أن يكون إجمالي الطول المشفّر 255 بايت أو أقل.
- إذا كانت قيمة
mValueفارغة، يتم التعامل مع المفتاح كسمة منطقية ويتم ترميزه كـ "مفتاح" (بدون=). - إذا لم تكن قيمة
mValueفارغة ولكن كانت قيمةmValueLengthصفرًا، يتم التعامل معها كقيمة فارغة ويتم ترميزها بالقيمة "key=".
إذا كانت قيمة mKey فارغة، يتم التعامل مع المخزن المؤقت mValue على أنّه ملف TXT-DATA مشفّر مسبقًا ويتم إلحاقه كما في رسالة نظام أسماء النطاقات.
mValue
const uint8_t * otDnsTxtEntry::mValue
قيمة سجلّ TXT أو تم ترميز TXT-DATA من قبل (بناءً على mKey).
mValueLength
uint16_t otDnsTxtEntry::mValueLength
عدد وحدات البايت في المخزن المؤقت mValue.
المراجِع
تنشأ المواضيع المرجعية لواجهة برمجة تطبيقات OpenThread من رمز المصدر المتاح على GitHub. للحصول على مزيد من المعلومات أو للمساهمة في مستنداتنا، يمكنك الاطّلاع على المراجع.