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 topmost device in the device tree. The root device represents a physical object.

Syntax 

HRESULT get_RootDevice(
  IUPnPDevice** 
ppudRootDevice
);

Parameters

ppudRootDevice

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

Return Value

S_OK

This method was successful.

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

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