IUPnPDeviceFinder::FindByType method (upnp.h)

Article
10/13/2021

The FindByType method searches synchronously for devices by device type or service type.

Syntax

HRESULT FindByType(
  [in]  BSTR         bstrTypeURI,
  [in]  DWORD        dwFlags,
  [out] IUPnPDevices **pDevices
);

Parameters

[in] bstrTypeURI

Specifies the type URI for the device or service type for which to search.

[in] dwFlags

Must be zero. This parameter is reserved for future use.

[out] pDevices

Receives a reference to a collection of IUPnPDevices devices that were found.

Return value

If the method succeeds, the return value is S_OK. Otherwise, the method returns one of the COM error codes defined in WinError.h.

Remarks

This method does not return until the search is complete. The search can take at least nine seconds, and possibly more. This method must not be called from a thread that processes user interface messages.

Requirements

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	None supported
Target Platform	Windows
Header	upnp.h
DLL	Upnp.dll