otDnsTxtEntry

#include <dns.h>

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

摘要

mKey 和 mValue 指向的字符串缓冲区在此类结构的实例传递到 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 上提供的源代码。如需了解详情，或者为我们的文档做贡献，请参阅资源。