otDnsTxtEntry

#include <dns.h>

Reprezentuje wpis w rekordzie TXT reprezentujący parę klucz/wartość (RFC 6763 – sekcja 6.3).

Podsumowanie

Bufory ciągu znaków, na które wskazuje mKey i mValue, MUSZĄ zostać zachowane i niezmienione po przekazaniu wystąpienia takiej struktury do OpenThread (w ramach instancji otSrpClientService).

Tablica wpisów otDnsTxtEntry jest używana w otSrpClientService do określenia pełnego rekordu TXT (listy wpisów).

Atrybuty publiczne
mKey
const char *
Ciąg klucza rekordu TXT.
mValue
const uint8_t *
Wartość rekordu TXT lub zakodowana już wartość TXT-DATA (w zależności od mKey).
mValueLength
uint16_t
Liczba bajtów w buforze mValue.

Atrybuty publiczne

mKey

const char * otDnsTxtEntry::mKey

Ciąg klucza rekordu TXT.

Jeśli mKey nie ma wartości NULL, MUSI być ciągiem C o wartości zerowej. Wpis jest traktowany jako para klucz-wartość z buforem mValue podającym wartość.

  • Wpis jest kodowany w następujący sposób:
    • Format z pojedynczym ciągiem znaków (w bajtach), po którym następuje „klucz=wartość” (bez cudzysłowów).
    • W tym przypadku łączna długość zakodowana nie może przekraczać 255 bajtów.
  • Jeśli mValue ma wartość NULL, klucz jest traktowany jako atrybut logiczny i zakodowany jako „klucz” (bez =).
  • Jeśli mValue nie ma wartości NULL, ale mValueLength wynosi 0, jest traktowana jako pusta wartość i zakodowana jako „key=”.

Jeśli mKey ma wartość NULL, bufor mValue jest traktowany jako już zakodowany TXT-DATA i jest dołączany w taki sam sposób jak w wiadomości DNS.

mValue

const uint8_t * otDnsTxtEntry::mValue

Wartość rekordu TXT lub zakodowana już wartość TXT-DATA (w zależności od mKey).

mValueLength

uint16_t otDnsTxtEntry::mValueLength

Liczba bajtów w buforze mValue.

Zasoby

Tematy referencyjne interfejsu OpenThread API pochodzą z kodu źródłowego dostępnego w GitHub. Aby dowiedzieć się więcej lub dołączyć do naszej dokumentacji, skorzystaj z sekcji Zasoby.