IUPnPDescriptionDocument：:D eviceByUDN 方法 (upnp.h)
DeviceByUDN方法會傳回具有指定唯一裝置名稱的裝置， (UDN) 包含在載入的描述檔中。
語法
HRESULT DeviceByUDN(
[in] BSTR bstrUDN,
[out] IUPnPDevice **ppudDevice
);
參數
[in] bstrUDN
指定裝置的 UDN。
[out] ppudDevice
接收 描述裝置之 IUPnPDevice 物件的參考。 當不再使用此參考時，必須釋放此參考。
傳回值
如果方法成功，傳回值會S_OK。 否則，方法會傳回 WinError.h 中定義的其中一個 COM 錯誤碼。
備註
使用IUPnPDescriptionDocument：：Load或IUPnPDescriptionDocument：：LoadAsync載入裝置描述之後，請使用DeviceByUDN。 IUPnPDescriptionDocument：：ReadyState屬性會傳回READYSTATE_COMPLETED。
除非第一次使用IUPnPDescriptionDocument：：Load或IUPnPDescriptionDocument：：LoadAsync載入裝置描述，否則請勿使用DeviceByUDN。 搜尋作業只會在目前載入的裝置描述中搜尋。
規格需求
| 最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
| 最低支援的伺服器 | 都不支援 |
| 目標平台 | Windows |
| 標頭 | upnp.h |
| Dll | Upnp.dll |