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 ระบบจะถือว่าคีย์เป็นแอตทริบิวต์บูลีนและเข้ารหัสเป็น "key" (โดยไม่มี =)
• หาก mValue ไม่ใช่ NULL แต่ mValueLength เป็น 0 ระบบจะถือว่าเป็นค่าว่างและเข้ารหัสเป็น "key="

หาก mKey เป็นค่าว่าง ระบบจะถือว่าบัฟเฟอร์ mValue เป็น TXT-DATA ที่เข้ารหัสแล้วและจะต่อท้ายตามเดิมในข้อความ DNS

mValue

const uint8_t * otDnsTxtEntry::mValue

ค่าระเบียน TXT หรือ TXT-DATA ที่เข้ารหัสแล้ว (ขึ้นอยู่กับ mKey)

mValueLength

uint16_t otDnsTxtEntry::mValueLength

จำนวนไบต์ในบัฟเฟอร์ mValue

แหล่งข้อมูล

หัวข้ออ้างอิง API ของ OpenThread จะมาจากซอร์สโค้ดซึ่งพร้อมใช้งานใน GitHub ดูข้อมูลเพิ่มเติมหรือมีส่วนร่วมในเอกสารประกอบของเราได้ที่แหล่งข้อมูล