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 עם סגירת null. הרשומה מטופלת כצמד מפתח/ערך עם מאגר נתונים זמני mValue שמספק את הערך.

  • הרשומה מקודדת כך:
    • בייטים באורך מחרוזת בודדים ואחריהם בפורמט "key=value" (ללא המירכאות).
    • במקרה כזה, האורך הכולל של הקידוד צריך להיות 255 בייטים או פחות.
  • אם הערך של mValue הוא NULL, המערכת מתייחסת למפתח כאל מאפיין בוליאני ומקודדת כ "מפתח" (ללא =).
  • אם 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. אפשר לקרוא מידע נוסף או לתרום למסמכי התיעוד שלנו בדף מקורות מידע.