otDnsTxtEntry

#include <dns.h>

कुंजी/वैल्यू के जोड़े (आरएफ़सी 6763 - सेक्शन 6.3) को दिखाने वाली TXT रिकॉर्ड एंट्री के बारे में बताता है.

खास जानकारी

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 शून्य नहीं है, तो इसे शून्य से खत्म होने वाली सी स्ट्रिंग होनी चाहिए. एंट्री को कुंजी/वैल्यू पेयर के तौर पर माना जाता है, जिसमें वैल्यू देने वाला mValue बफ़र होता है.

  • एंट्री को इस तरह कोड में बदला गया है:
    • सिंगल स्ट्रिंग की लंबाई वाला बाइट और इसके बाद "key=value" फ़ॉर्मैट (उद्धरण चिह्नों के बिना).
    • इस मामले में, कोड में बदली गई कुल लंबाई 255 बाइट या उससे कम होनी चाहिए.
  • अगर mValue NULL है, तो कुंजी को बूलियन एट्रिब्यूट के तौर पर माना जाता है और इसे "key" (बिना = के) के तौर पर कोड में बदला जाता है.
  • अगर mValue, NULL नहीं है, लेकिन mValueLength शून्य है, तो इसे खाली वैल्यू माना जाता है. साथ ही, इसे "key=" के तौर पर कोड में बदला जाता है.

अगर mKey NULL है, तो mValue बफ़र को पहले से कोड में बदले गए TXT-DATA के तौर पर माना जाता है और इसे डीएनएस मैसेज की तरह ही जोड़ा जाता है.

mValue

const uint8_t * otDnsTxtEntry::mValue

TXT रिकॉर्ड मान या पहले से कोड में बदला गया TXT-DATA (mKey के आधार पर).

mValueLength

uint16_t otDnsTxtEntry::mValueLength

mValue बफ़र में बाइट की संख्या.

संसाधन

OpenThread API के रेफ़रंस के विषय, सोर्स कोड से मिलते हैं. यह सोर्स GitHub पर उपलब्ध है. ज़्यादा जानकारी या हमारे दस्तावेज़ में योगदान देने के लिए, संसाधन देखें.