IUPnPDeviceFinder::FindByUDN method (upnp.h)

The FindByUDN method searches synchronously for a device by its unique device name (UDN).

Syntax

HRESULT FindByUDN(
  [in]  BSTR        bstrUDN,
  [out] IUPnPDevice **pDevice
);

Parameters

[in] bstrUDN

Specifies the UDN for which to search. This value is case sensitive, and should be provided as lower-case (e.g. uuid:e8f85dfd-ff...).

[out] pDevice

Receives a reference to an IUPnPDevice object that contains the requested device. Receives NULL if the specified device is not found.

Return value

If the method succeeds, the return value is S_OK. Otherwise, the method returns S_FALSE.

Remarks

This method returns as soon as a device that matches the specified UDN is found. If no device is found, the method takes at least nine seconds to return, and possibly longer.

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::FindByType

IUPnPDevices