Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

The IUPnPDeviceFinderinterface enables both synchronous and asynchronous searches. Asynchronous searches return control to the calling application immediately. The application is notified about each individual device as it is found, using a callback interface registered by the application.

Asynchronous searches are best used for graphical user interfaces and applications that perform continuous monitoring.

Because an asynchronous search runs in the background until you cancel it, it will find devices that are on the network at the time of the search and any devices that appear at a later time.

To perform an asynchronous search:

  1. Create an IUPnPDeviceFinderinstance, as explained in Device Finder Creation.

  2. Create an asynchronous search operation using IUPnPDeviceFinder::CreateAsyncFind.

  3. Start the asynchronous search operation using IUPnPDeviceFinder::StartAsyncFind.

  4. Receive callback notifications and take the appropriate processing steps.

  5. When the search is no longer needed, cancel the search and release the associated objects.

See Also