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 取得。如要瞭解詳情或對說明文件做出貢獻，請參閱資源。