ot::Dns::Client::ServiceResponse class

Represents a service instance resolution DNS response.

Syntax

Show:

Summary

Declaration

from dns_client.hpp:495

class ServiceResponse : public Response { friend class Client; public: Error GetServiceName(char *aLabelBuffer, uint8_t aLabelBufferSize, char *aNameBuffer, uint16_t aNameBufferSize) const; Error GetServiceInfo(ServiceInfo &aServiceInfo) const; Error GetHostAddress(const char *aHostName, uint16_t aIndex, Ip6::Address &aAddress, uint32_t &aTtl) const; };

Methods

GetServiceName() const

Gets the service instance name associated with a DNS service instance resolution response. MUST only be used from `ServiceCallback`.

GetServiceInfo() const

Gets info for a service instance from a DNS service instance resolution response. MUST only be used from `ServiceCallback`. - If no matching SRV record is found, `kErrorNotFound` is returned. - If a matching SRV record is found, @p aServiceInfo is updated and `kErrorNone` is returned. - If no matching TXT record is found, `mTxtDataSize` in @p aServiceInfo is set to zero. - If no matching AAAA record is found, `mHostAddress is set to all zero or unspecified address. - If there are multiple AAAA records for the host name, `mHostAddress` is set to the first one. The other addresses can be retrieved using `GetHostAddress()` method.

GetHostAddress() const

Gets the host IPv6 address from a DNS service instance resolution response. MUST only be used from `ServiceCallback`. The response can include zero or more IPv6 address records. @p aIndex can be used to iterate through the list of addresses. Index zero gets the first address and so on. When we reach end of the list, this method returns `kErrorNotFound`.