IUPnPDeviceFinder::FindByType method (upnp.h)

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

See also

IUPnPDeviceFinder

IUPnPDeviceFinder::FindByUDN

IUPnPDevices