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，則它必須是空值的結尾 C 字串。系統會將項目視為鍵/值組合，與提供值的 mValue 緩衝區。

  • 項目編碼方式如下：
    • 一個字串長度的位元組，後面接上「key=value」格式 (不含引號)。
    • 在這種情況下，編碼的整體長度不得超過 255 個位元組。
  • 如果 mValue 為 NULL，系統會將鍵視為布林值屬性，並編碼為「鍵」(不含 =)。
  • 如果 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 取得。如要瞭解詳情或對說明文件做出貢獻，請參閱資源。