Symbols ![]()
loading...
Files ![]()
loading...
otDnsBrowseResponseGetServiceInstance() function
Gets a service instance associated with a DNS browse (service instance enumeration) response. MUST only be used from `otDnsBrowseCallback`. The response may include multiple service instance records. @p aIndex can be used to iterate through the list. Index zero gives the first record. When we reach end of the list, `OT_ERROR_NOT_FOUND` is returned. Note that this function gets the service instance label and not the full service instance name which is of the form `..`.
Syntax
otError otDnsBrowseResponseGetServiceInstance(const otDnsBrowseResponse *aResponse,
uint16_t aIndex,
char *aLabelBuffer,
uint8_t aLabelBufferSize);
Implemented in ![]()
dns_api.cpp:163
Return value
OT_ERROR_NONE The service instance was read successfully. OT_ERROR_NO_BUFS The name does not fit in @p aNameBuffer. OT_ERROR_NOT_FOUND No service instance record in @p aResponse at @p aIndex. OT_ERROR_PARSE Could not parse the records in the @p aResponse.
Related Functions
Found 4 other functions taking a ![]()
otDnsBrowseResponse
argument:
Function
Description
Gets the service name associated with a DNS browse (service instance enumeration) response. MUST only be used from `otDnsBrowseCallback`.
Gets info for a service instance from a DNS browse (service instance enumeration) response. MUST only be used from `otDnsBrowseCallback`. A browse DNS response can include SRV, TXT, and AAAA records for the service instances that are enumerated. This is a SHOULD and not a MUST requirement, and servers/resolvers are not required to provide this. This function attempts to retrieve this info for a given service instance when available. - If no matching SRV record is found in @p aResponse, `OT_ERROR_NOT_FOUND` is returned. In this case, no additional records (no TXT and/or AAAA) are read. - If a matching SRV record is found in @p aResponse, @p aServiceInfo is updated and `OT_ERROR_NONE` is returned. - If no matching TXT record is found in @p aResponse, `mTxtDataSize` in @p aServiceInfo is set to zero. - If TXT data length is greater than `mTxtDataSize`, it is read partially and `mTxtDataTruncated` is set to true. - If no matching AAAA record is found in @p aResponse, `mHostAddress is set to all zero or unspecified address. - If there are multiple AAAA records for the host name in @p aResponse, `mHostAddress` is set to the first one. The other addresses can be retrieved using `otDnsBrowseResponseGetHostAddress()`.
Gets the host IPv6 address from a DNS browse (service instance enumeration) response. MUST only be used from `otDnsBrowseCallback`. 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, `OT_ERROR_NOT_FOUND` is returned.