otDnsTxtEntry

#include <dns.h>

Đại diện cho một mục của bản ghi TXT đại diện cho một cặp khoá/giá trị (RFC 6763 – phần 6.3).

Tóm tắt

Các vùng đệm chuỗi do mKey và mValue trỏ đến PHẢI duy trì và không thay đổi sau khi một thực thể của cấu trúc như vậy được chuyển đến OpenThread (như một phần của thực thể otSrpClientService).

Một mảng các mục nhập otDnsTxtEntry được dùng trong otSrpClientService để chỉ định bản ghi TXT đầy đủ (danh sách các mục nhập).

Thuộc tính công khai
mKey
const char *
Chuỗi khoá bản ghi TXT.
mValue
const uint8_t *
Giá trị bản ghi TXT hoặc TXT-DATA đã được mã hoá (tuỳ thuộc vào mKey).
mValueLength
uint16_t
Số byte trong vùng đệm mValue.

Thuộc tính công khai

mKey

const char * otDnsTxtEntry::mKey

Chuỗi khoá bản ghi TXT.

Nếu mKey không phải là NULL, thì đó PHẢI là một chuỗi C kết thúc rỗng. Mục nhập được coi là cặp khoá/giá trị với vùng đệm mValue cung cấp giá trị.

  • Mục nhập này được mã hoá như sau:
    • Một byte độ dài chuỗi đơn theo sau là định dạng "key=value" (không có dấu ngoặc kép).
    • Trong trường hợp này, chiều dài tổng thể được mã hoá phải từ 255 byte trở xuống.
  • Nếu mValue là NULL (Rỗng) thì khoá sẽ được coi là thuộc tính boolean và được mã hoá là "khoá" (không có =).
  • Nếu mValue không phải là NULL nhưng mValueLength bằng 0, thì giá trị này sẽ được coi là giá trị trống và được mã hoá là "key=".

Nếu mKey là NULL thì vùng đệm mValue sẽ được coi là một TXT-DATA đã mã hoá và được thêm vào như trong thông báo DNS.

mValue

const uint8_t * otDnsTxtEntry::mValue

Giá trị bản ghi TXT hoặc TXT-DATA đã được mã hoá (tuỳ thuộc vào mKey).

mValueLength

uint16_t otDnsTxtEntry::mValueLength

Số byte trong vùng đệm mValue.

Tài nguyên

Các chủ đề tham khảo API OpenThread bắt nguồn từ mã nguồn, có trên GitHub. Để biết thêm thông tin hoặc để đóng góp cho tài liệu của chúng tôi, hãy tham khảo Tài nguyên.