otDnsTxtEntry

#include <dns.h>

Stellt einen TXT-Eintrageintrag dar, der ein Schlüssel/Wert-Paar darstellt (RFC 6763 – Abschnitt 6.3).

Zusammenfassung

Der Stringzwischenspeicher, auf den mKey und mValue verweisen, MÜSSEN beibehalten werden und unverändert bleiben, nachdem eine Instanz dieser Struktur an OpenThread (als Teil der otSrpClientService-Instanz) übergeben wurde.

In otSrpClientService wird ein Array mit otDnsTxtEntry-Einträgen verwendet, um den vollständigen TXT-Eintrag (eine Liste der Einträge) anzugeben.

Öffentliche Attribute
mKey
const char *
Der String des TXT-Eintragsschlüssels.
mValue
const uint8_t *
Der Wert des TXT-Eintrags oder bereits codierte TXT-DATEN (abhängig von mKey).
mValueLength
uint16_t
Anzahl der Byte im Zwischenspeicher mValue.

Öffentliche Attribute

mKey

const char * otDnsTxtEntry::mKey

Der String des TXT-Eintragsschlüssels.

Wenn mKey nicht NULL ist, MUSS es ein auf Null beendeter C-String sein. Der Eintrag wird als Schlüssel/Wert-Paar behandelt, wobei der Wert vom mValue-Zwischenspeicher bereitgestellt wird.

  • Der Eintrag ist wie folgt codiert:
    • Ein Byte mit einer Stringlänge, gefolgt vom Format „Schlüssel=Wert“ (ohne Anführungszeichen).
    • In diesem Fall darf die gesamte codierte Länge 255 Byte oder weniger betragen.
  • Wenn mValue NULL ist, wird der Schlüssel als boolesches Attribut behandelt und als „Schlüssel“ codiert (ohne =).
  • Wenn mValue nicht NULL ist, mValueLength aber null ist, wird der Wert als leerer Wert behandelt und als "key=" codiert.

Wenn mKey NULL ist, wird der Zwischenspeicher mValue als bereits codierte TXT-DATEN behandelt und wie in der DNS-Nachricht angehängt.

mValue

const uint8_t * otDnsTxtEntry::mValue

Der Wert des TXT-Eintrags oder bereits codierte TXT-DATEN (abhängig von mKey).

mValueLength

uint16_t otDnsTxtEntry::mValueLength

Anzahl der Byte im Zwischenspeicher mValue.

Ressourcen

OpenThread API-Referenzthemen stammen aus dem Quellcode, der auf GitHub verfügbar ist. Weitere Informationen finden Sie unter Ressourcen. Dort können Sie auch einen Beitrag zu unserer Dokumentation leisten.