The DNSSDBrowser class allows browsing for services, domains and records, resolving services and error handling. Browse and resolve operations are asynchronous. Discovered services, records and domains, as well as error conditions are reported via events.

A DNSSDBrowser object is never created directly. It can be obtained from the DNSSDResponder by calling the DNSSDResponder::serviceBrowser() method.

A note on implementing event handlers: An event handler should complete its work and return as quick as possible, otherwise it may interfere with DNS-SD processing. An event handler should never wait for other events to happen. Specifically, it must never wait for an other DNSSDBrowser event to happen, as this will result in a deadlock.

Flags reported in event arguments.

This flag signals that more events will follow immediately. For the application this means for example that updates to the user interface can be delayed until an event is fired that does not have this flag set.

Options for browsing, resolving and DNS queries.

Attempt to resolve the service on the interface it was discovered on only.

Attempt to resolve the service on all interfaces.

Force query to be performed with a link-local mDNS query, even if the name is an apparently non-local name (i.e. a name not ending in ".local.").

Create a "long-lived" unicast query in a non-local domain. Without enabling this option, unicast queries will be one-shot — that is, only answers available at the time of the call will be returned. By setting this flag, answers that become available after the initial call is made will generate events. This flag has no effect on link-local multicast queries.

Browse for a service type on a specific network interface, given by its index in networkInterface. An interface with index 0 can be specified to search on all interfaces.

• regType specifies the service type and protocol, separated by a dot (e.g., "_ftp._tcp"). The transport protocol must be either "_tcp" or "_udp". Optionally, a single subtype may be specified to perform filtered browsing: e.g. browsing for "_primarytype._tcp,_subtype" will discover only those instances of "_primarytype._tcp" that were registered specifying "_subtype" in their list of registered subtypes.
• domain specifies the domain on which to browse for services. If an empty string is specified, the default domain(s) will be browsed.
• options should be 0, as no browse options are currently supported.

Results will be reported asynchronously via the serviceFound, serviceRemoved and serviceError events.

The returned BrowseHandle can be passed to cancel() to cancel browsing.

Note: It is possible to enumerate all service types registered on the local network by browsing for the special regType "_services._dns-sd._udp". Available service types will be reported with the Service object's name containing the service type (e.g., "_ftp") and the Service's type containing the protocol and domain (e.g., "_tcp.local.").

Cancels the browse or resolve activity associated with the given BrowseHandle.

The BrowseHandle is invalidated.

Discovers domains for browse operations on the given interface, given by its index. An interface with index 0 can be specified to search on all interfaces.

Results will be sent asnychronously via the browseDomainFound, browseDomainRemoved and browseDomainError events.

Discovers domains for service registration on the given interface, given by its index. An interface with index 0 can be specified to search on all interfaces.

Results will be sent asnychronously via the registrationDomainFound, registrationDomainRemoved and registrationDomainError events.

The returned BrowseHandle can be passed to cancel() to cancel resolving.

Starts a query for a DNS record, specified by name, type and clazz, on the specified interface, given by its index. An interface with index 0 can be specified to search on all interfaces.

• name specifies the full domain name of the record.
• type specifies the record's type (e.g., RT_PTR). Suitable values can be found in the RecordType enumeration.
• clazz specifies the record's class (usually RC_IN).
• options can be 0, BROWSE_FORCE_MULTICAST or BROWSE_LONG_LIVED_QUERY.

Results will be sent asnychronously via the recordFound, recordRemoved and recordError events.

The returned BrowseHandle can be passed to cancel() to cancel the query.

Resolves the service specified by the given Service object. The given Service object must be one obtained via the serviceFound event.

Results will be sent asnychronously via the serviceResolved and resolveError events.

If RESOLVE_ON_ALL_INTERFACES is specified in options, resolving will be attempted on all network interfaces. Otherwise, if RESOLVE_ON_DISCOVERED_INTERFACE is specified, resolving will only be attempted on the interfaces on which the service has been discovered.

The returned BrowseHandle can be passed to cancel() to cancel resolving. However, this should be done before either the serviceResolved or resolveError event has been fired. In practice, this has high potential for a race condition, so calling cancel() with a BrowseHandle returned from this function is not recommended. After either the serviceResolved or resolveError event has been fired, the returned BrowseHandle is no longer valid.

Resolves the given host name. The given host name should have been obtained by resolving a service. An interface with index 0 can be specified to search on all interfaces.

• host specifies the hostname to resolve. It should be a hostname obtained by resolving a service.
• options can be 0 or BROWSE_FORCE_MULTICAST.

This should be used instead of Poco::Net::DNS to resolve host names via Multicast DNS, if the system's domain name resolver does not support Multicast DNS.

Results will be sent asnychronously via the hostResolved and hostResolveError events.

The returned BrowseHandle can be passed to cancel() to cancel resolving. However, this should be done before either the hostResolved or hostResolveError event has been fired. In practice, this has high potential for a race condition, so calling cancel() with a BrowseHandle returned from this function is not recommended. After either the hostResolved or hostResolveError event has been fired, the returned BrowseHandle is no longer valid.

Fired when an error occures while browsing for browse domains.

The specific error condition can be found by looking at the Error object in the argument.

Fired when a browse domain has been found.

Fired when a browse domain has been removed and is no longer available.

Fired when an error occures while browsing for services.

The specific error condition can be found by looking at the Error object in the argument.

Fired when an error occurs while resolving a host name.

The specific error condition can be found by looking at the Error object in the argument.

Fired when a host name has been resolved.

Fired when an error occures while browsing for a record type.

The specific error condition can be found by looking at the Error object in the argument.

Fired when a record has been found.

Fired when a record has been removed and is no longer available.

Fired when an error occures while browsing for registration domains.

The specific error condition can be found by looking at the Error object in the argument.

Fired when a registration domain has been found.

Fired when a registration domain has been removed and is no longer available.

Fired when an error occures while resolving a service.

The specific error condition can be found by looking at the ServiceError object in the argument.

Fired when a service has been found.

The Service object given in the argument can be passed to resolve() to resolve the service, and to obtain the service's host and port number.

Fired when a service has been removed and is no longer available.

The Service object given in the argument can be passed to resolve() to resolve the service, and to obtain the service's host and port number.

Fired when a service has been successfully resolved.