Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This method returns the device with the specified UDN contained within the loaded description document.

Syntax 

HRESULT DeviceByUDN(
  BSTR 
bstrUDN,
  IUPnPDevice** 
ppudDevice
);

Parameters

bstrUDN

[in] Specifies the UDN of the device.

ppudDevice

[out] Receives a reference to an IUPnPDevice:IDispatchobject that describes the device. This reference must be released when it is no longer needed.

Return Value

S_OK

This method was successful.

Otherwise, this method returns one of the COM error codes defined in WinError.h.

Remarks

Do not use DeviceByUDNunless a device description is first loaded using either IUPnPDescriptionDocument::Loador IUPnPDescriptionDocument::LoadAsync. The search operation only searches in the currently loaded device description.

Requirements

Header upnp.h
Library uuid.lib
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also