CFNetServiceBrowserSearchForServices(_:_:_:_:)

Searches a domain for services of a specified type.

Declaration

func CFNetServiceBrowserSearchForServices(_ browser: CFNetServiceBrowser, _ domain: CFString, _ serviceType: CFString, _ error: UnsafeMutablePointer<CFStreamError>?) -> Bool

Parameters

browser:
The CFNetServiceBrowser, obtained by previously calling Cfnetservicebrowsercreate(_:_:_:), that is to perform the search; cannot be NULL.
domain:
The domain to search for the service type; cannot be NULL. To get the domains that are available for searching, call Cfnetservicebrowsersearchfordomains(_:_:_:).
error:
A pointer to a doc://com.apple.documentation/documentation/corefoundation/cfstreamerror structure, that, if an error occurs, will be set to the error and the error’s domain and passed to your callback function. Pass NULL if you don’t want to receive the error that may occur as a result of this particular call.

Return Value

TRUE if the search was started (asynchronous mode); FALSE if another search is already in progress for this CFNetServiceBrowser or if an error occurred.

Discussion

This function searches the specified domain for services that match the specified service type. The search continues until the search is canceled by calling CFNetServiceBrowserStopSearch(_:_:). When a match is found, the callback function specified when the CFNetServiceBrowser was created is called and passed an instance of a CFNetService representing the service that was found.

In asynchronous mode, this function returns TRUE if the search was started. Otherwise, it returns FALSE.

In synchronous mode, this function blocks until the search is stopped by calling CFNetServiceBrowserStopSearch(_:_:) from another thread, in which case this function returns FALSE, or until an error occurs.

Special Considerations

This function is thread safe.

For any one CFNetServiceBrowser, only one domain search or one service search can be in progress at the same time.