otDnsTxtEntry

#include <dns.h>

表示表示键值对的 TXT 记录条目(RFC 6763 - 第 6.3 节)。

摘要

mKeymValue 指向的字符串缓冲区在此类结构的实例传递到 OpenThread(作为 otSrpClientService 实例的一部分)后必须保留且保持不变。

otSrpClientService 中使用 otDnsTxtEntry 条目数组来指定完整的 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,它必须是以 null 结尾的 C 字符串。将相应条目视为键值对,其中 mValue 缓冲区提供相应值。

  • 该条目的编码如下所示:
    • 单个字符串长度字节,后跟“key=value”格式(不含引号)。
    • 在这种情况下,整个编码长度不得超过 255 个字节。
  • 如果 mValue 为 NULL,则 key 会被视为布尔值属性并编码为“key”(没有 =)。
  • 如果 mValue 不是 NULL,但 mValueLength 为零,则将其视为空值并编码为“key=”。

如果 mKey 为 NULL,则 mValue 缓冲区将被视为已编码的 TXT-DATA,并按照与 DNS 消息相同的方式附加。

mValue

const uint8_t * otDnsTxtEntry::mValue

TXT 记录值或已编码的 TXT-DATA(具体取决于 mKey)。

mValueLength

uint16_t otDnsTxtEntry::mValueLength

mValue 缓冲区中的字节数。

资源

OpenThread API 参考文档源自 GitHub 上提供的源代码。如需了解详情,或者为我们的文档做贡献,请参阅资源