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 NULL نیست، پس باید یک رشته C با تهی باشد. ورودی به عنوان جفت کلید/مقدار با بافر mValue که مقدار را ارائه می کند، در نظر گرفته می شود.

  • ورودی به صورت زیر کدگذاری می شود:
    • یک بایت طول رشته تک به دنبال فرمت "key=value" (بدون علامت نقل قول).
    • در این مورد، طول کلی رمزگذاری شده باید 255 بایت یا کمتر باشد.
  • اگر mValue NULL باشد، کلید به عنوان یک ویژگی بولی در نظر گرفته می شود و به عنوان "کلید" (با no = ) کدگذاری می شود.
  • اگر mValue NULL نباشد اما mValueLength صفر باشد، آنگاه به عنوان مقدار خالی در نظر گرفته می شود و به عنوان "key=" کدگذاری می شود.

اگر mKey NULL باشد، بافر mValue به عنوان یک TXT-DATA از قبل کدگذاری شده در نظر گرفته می شود و همانطور که در پیام DNS است اضافه می شود.

mValue

const uint8_t * otDnsTxtEntry::mValue

مقدار رکورد TXT یا TXT-DATA قبلاً کدگذاری شده (بسته به mKey ).

mValueLength

uint16_t otDnsTxtEntry::mValueLength

تعداد بایت ها در بافر mValue .

منابع

موضوعات مرجع OpenThread API از کد منبع موجود در GitHub سرچشمه می گیرند. برای اطلاعات بیشتر، یا مشارکت در اسناد ما، به منابع مراجعه کنید.