IUPnPDeviceFinder：：FindByUDN 方法 (upnp.h)

FindByUDN 方法按其唯一设备名称 (UDN) 同步搜索设备。

语法

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

[in] bstrUDN

指定要搜索的 UDN。此值区分大小写，应以小写 (提供，例如 uuid：e8f85dfd-ff...) 。

[out] pDevice

接收对包含所请求设备的 IUPnPDevice 对象的引用。如果未找到指定的设备，则接收 NULL 。

如果该方法成功，则返回值S_OK。否则，该方法返回S_FALSE。

此方法在找到与指定 UDN 匹配的设备后立即返回。如果未找到设备，该方法至少需要 9 秒才能返回，并且可能更长。