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 的裝置時立即傳回。如果找不到任何裝置，則方法至少需要九秒的時間才能傳回，而且可能更長。