otDnsTxtEntry

#include <dns.h>

Représente une entrée d'enregistrement TXT représentant une paire clé/valeur (RFC 6763, section 6.3).

Résumé

Les tampons de chaîne pointant vers mKey et mValue DOIVENT conserver et rester inchangés après qu'une instance de cette structure est transmise à OpenThread (dans le cadre de l'instance otSrpClientService).

Un tableau d'entrées otDnsTxtEntry est utilisé dans otSrpClientService pour spécifier l'enregistrement TXT complet (liste d'entrées).

Attributs publics
mKey
const char *
Chaîne de clé d'enregistrement TXT.
mValue
const uint8_t *
Valeur de l'enregistrement TXT ou TXT-DATA déjà encodée (selon mKey).
mValueLength
uint16_t
Nombre d'octets dans le tampon mValue.

Attributs publics

mKey

const char * otDnsTxtEntry::mKey

Chaîne de clé d'enregistrement TXT.

Si mKey n'est pas NULL, il DOIT s'agir d'une chaîne C se terminant par une valeur nulle. L'entrée est traitée comme une paire clé/valeur où le tampon mValue fournit la valeur.

  • L'entrée est encodée comme suit:
    • Un octet de longueur de chaîne unique suivi du format "clé=valeur" (sans les guillemets).
    • Dans ce cas, la longueur totale encodée doit être inférieure ou égale à 255 octets.
  • Si mValue est NULL, la clé est traitée comme un attribut booléen et encodée en tant que "key" (sans =).
  • Si mValue n'est pas NULL, mais que mValueLength est égal à zéro, elle est traitée comme une valeur vide et encodée en tant que "key=".

Si mKey est NULL, le tampon mValue est traité comme un TXT-DATA déjà encodé et est ajouté tel quel dans le message DNS.

mValue

const uint8_t * otDnsTxtEntry::mValue

Valeur de l'enregistrement TXT ou TXT-DATA déjà encodée (selon mKey).

mValueLength

uint16_t otDnsTxtEntry::mValueLength

Nombre d'octets dans le tampon mValue.

Ressources

Les sujets de référence de l'API OpenThread proviennent du code source, disponible sur GitHub. Pour en savoir plus ou pour contribuer à notre documentation, consultez la section Ressources.